{"id":445106,"date":"2026-10-28T11:01:08","date_gmt":"2026-10-28T10:01:08","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/api-rest-liens-d-action\/"},"modified":"2026-10-28T12:53:37","modified_gmt":"2026-10-28T11:53:37","password":"","slug":"api-rest-liens-d-action","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/fr\/documentation\/api\/api-rest-liens-d-action\/","title":{"rendered":"API REST – Liens d’action"},"content":{"rendered":"

Un lien d’action permet \u00e0 un destinataire sans compte de confirmer une action pr\u00e9vue sur une fiche : accepter un devis, clore un ticket, se d\u00e9sinscrire. L’adresse renvoy\u00e9e ouvre une page de confirmation ; la fiche n’est modifi\u00e9e qu’au clic sur Confirmer<\/strong>, une seule fois, pendant 30 jours. Fonctionnement d\u00e9taill\u00e9 : Les liens d’action dans les e-mails<\/a>.<\/p>\n

Un lien ne donne jamais plus de droits que son cr\u00e9ateur : il faut pouvoir faire soi-m\u00eame la modification, comme \u00e0 l’\u00e9cran. C’est le droit de modifier la fiche et le champ, ou, sur un devis, une commande ou une facture finalis\u00e9s, la Modification partielle du champ (la phase d’un devis envoy\u00e9, par exemple).<\/p>\n

Lister les actions possibles<\/h2>\n
\n

GET<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n

\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\naction_link_actions<\/code><\/td>\n<\/tr>\n
sessionName<\/code><\/td>\nstring<\/td>\noui<\/td>\nIdentifiant de session<\/td>\n<\/tr>\n
module<\/code><\/td>\nstring<\/td>\nnon<\/td>\nModule des fiches vis\u00e9es, par exemple Quotes<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
curl "https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php?operation=action_link_actions&sessionName=YOUR_SESSION_ID&module=Quotes"\n<\/code><\/pre>\n
La r\u00e9ponse contient actions<\/code> (module, action, libell\u00e9, attributs, dur\u00e9e de vie en jours ; *<\/code> d\u00e9signe une action disponible sur tous les modules). Avec module<\/code>, elle contient aussi settableFields<\/code> : les listes d\u00e9roulantes et cases \u00e0 cocher que vous pouvez faire modifier par un lien, avec leurs valeurs.<\/p>\n
Cr\u00e9er un lien<\/h2>\n
\n
POST<\/strong> https:\/\/apps.kafinea.com\/{instance}\/webservice.php<\/code><\/p>\n<\/blockquote>\n
\n\n\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nType<\/th>\nRequis<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\nstring<\/td>\noui<\/td>\naction_link_create<\/code><\/td>\n<\/tr>\n
sessionName<\/code><\/td>\nstring<\/td>\noui<\/td>\nIdentifiant de session<\/td>\n<\/tr>\n
id<\/code><\/td>\nstring<\/td>\noui<\/td>\nID Webservice de la fiche<\/td>\n<\/tr>\n
action<\/code><\/td>\nstring<\/td>\noui<\/td>\nAction \u00e0 proposer, par exemple set-field<\/code><\/td>\n<\/tr>\n
attributes<\/code><\/td>\nJSON<\/td>\nselon l’action<\/td>\nPour set-field<\/code> : field<\/code>, value<\/code> et, facultatif, une question<\/code> courte affich\u00e9e sur la page<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
curl -X POST https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php \\\n  -d "operation=action_link_create" \\\n  -d "sessionName=YOUR_SESSION_ID" \\\n  -d "id=4x1234" \\\n  -d "action=set-field" \\\n  --data-urlencode 'attributes={"field":"quotestage","value":"Accepted","question":"Acceptez-vous ce devis ?"}'\n<\/code><\/pre>\n
{\n  "success": true,\n  "result": {\n    "url": "https:\/\/apps.kafinea.com\/YourKafinea\/shorturl.php?id=9f2c\u2026",\n    "expiresAt": "2026-11-24T10:00:00+00:00",\n    "module": "Quotes",\n    "action": "set-field",\n    "id": "4x1234"\n  }\n}\n<\/code><\/pre>\n
Cr\u00e9er le lien ne modifie pas la fiche. Remettez l’adresse uniquement \u00e0 son destinataire : quiconque la d\u00e9tient peut confirmer l’action.<\/p>\n
R\u00e8gles et erreurs<\/h2>\n