Le 3 juin 2026, Evalandgo évolue : nouvelle version

Vos automatisations et Webhooks continuent de fonctionner. L’API évolue avec deux changements mineurs : nous vous expliquons tout dans la FAQ.

Changements importants (actions requises)

1. Formats de contenu acceptés réduits

Les formats suivants ne sont plus supportés, ni en requête, ni en réponse :

• application/hal+json
• application/vnd.api+json
• application/xml / text/xml
• application/x-yaml
• text/csv
• text/html

Formats maintenus : application/json et application/ld+json.

2. POST /api/v3/contacts — format de contactFields modifié

Le champ contactFields ne prend plus des IRI en chaîne, mais des objets avec les propriétés field et value :

// Avant
"contactFields": ["/api/v3/contact-fields/42"]

// Après
"contactFields": [
  { "field": "/api/v3/contact-fields/42", "value": "Ma valeur" }
]

Ce changement ne concerne pas POST /api/v3/respondents ni POST /api/v3/respondents/get-or-create, qui restent inchangés.

Nouveautés

Mises à jour partielles avec la nouvelle méthode PATCH

Jusqu’ici, modifier une ressource passait obligatoirement par un PUT, c’est-à-dire en envoyant l’objet complet dans le corps de la requête. Tous les champs omis étaient réinitialisés à null.

La méthode PATCH est désormais disponible sur les mêmes endpoints et permet d’envoyer uniquement les champs à modifier. Les autres restent inchangés.

// PUT — tous les champs obligatoires, les omis sont écrasés
PUT /api/v3/respondents/123
{ "firstName": "Jean", "lastName": "Dupont", "email": "jean@example.com", "finish": false }

// PATCH — seuls les champs envoyés sont modifiés
PATCH /api/v3/respondents/123
{ "email": "nouveau@example.com" }

À noter : vos requêtes PUT existantes restent inchangées et continuent de fonctionner exactement comme avant. PATCH est une option, pas une obligation.

Endpoints concernés par PATCH :

• PATCH /api/v3/respondents/{id}
• PATCH /api/v3/webhooks/{id}
• PATCH /api/v3/responses/datetime/{id}
• PATCH /api/v3/responses/multiple/{id}
• PATCH /api/v3/responses/nps/{id}
• PATCH /api/v3/responses/number/{id}
• PATCH /api/v3/responses/rating/{id}
• PATCH /api/v3/responses/scale/{id}
• PATCH /api/v3/responses/slider/{id}
• PATCH /api/v3/responses/text/{id}
• PATCH /api/v3/responses/unique/{id}
• PATCH /api/v3/responses/form/{responseId}/inputs/{inputId}
• PATCH /api/v3/responses/emoticon/{id}

Nouveaux endpoints

• GET /api/v3/questions/item-text/{id} : récupère un élément de texte statique dans une page de questionnaire.
• PUT /api/v3/responses/emoticon/{id} et PATCH /api/v3/responses/emoticon/{id} : enregistre ou modifie la réponse à une question de type émoji.

Réponses d’erreur structurées

Les réponses 400, 404 et 422 retournent désormais un corps JSON avec le détail de l’erreur. Les erreurs de validation (422) incluent la liste des violations de contraintes (champ concerné, message, code) pour faciliter le debug.