Parcourir une liste
Les listes paginées exposent data et meta. Reprenez meta.nextCursor dans cursor tant que meta.hasMore vaut true, en conservant vos filtres. La limite habituelle est de 50 éléments, avec un maximum de 200 ; vérifiez les paramètres de chaque opération.
GET /contacts?limit=50
GET /contacts?limit=50&cursor=NEXT_CURSORMontants et devises
Les montants des paiements sont exprimés en unités mineures : 1500 représente 15,00 EUR. Les promesses utilisent des unités majeures. Vérifiez toujours le schéma du champ et sa devise.
Modifier un contenu multilingue
La langue principale de l’organisation se trouve à la racine de l’objet. Les autres langues sont des objets partiels sous leur code de langue. Lisez defaultLanguage et enabledLanguages dans GET /me.
{
"label": "Restaurant",
"en": {"label": "Restaurant"},
"he": {"label": "מסעדה"}
}Dans un PATCH, un champ absent reste inchangé. Un overlay de langue à null supprime cette traduction. Les règles de suppression des autres champs dépendent de leur schéma.
Contenu multilingue (à lire avant de renseigner un champ texte). Le contenu traduisible n’utilise PAS une correspondance {fr:…, en:…}. À la place :
- La valeur dans la langue par défaut de l’organisation (
org.language) se trouve à la RACINE de l’objet — jamais sous sa propre clé de langue. - Chaque autre langue activée par l’organisation (
org.languages) est une surcharge partielle, indexée par son code de langue et ne contenant que les champs traduisibles.
{ "label": "Restaurant", "he": { "label": "מסעדה" } } // org default = French
Les clés de surcharge valides sont dynamiques pour chaque organisation : ses langues activées, moins la langue par défaut. L’envoi de la langue par défaut comme surcharge est rejeté (cela dupliquerait la racine) ; une langue non prise en charge est ignorée sans avertissement. Un champ absent d’une surcharge reprend la valeur de la racine.
Modifier ou supprimer une traduction — lors d’une mise à jour partielle (PATCH), l’omission d’une clé signifie « la laisser telle quelle ». Par conséquent :
| Corps | Effet sur la traduction he |
|---|---|
{"he": {"label": "מסעדה"}} |
créée ou remplacée |
| (clé omise) | laissée intacte |
{"he": null} |
supprimée (toute la surcharge he est retirée) |
{"he": {}} |
également supprimée — une surcharge vide ne contient aucune traduction |
Pour supprimer une traduction, envoyez explicitement null pour cette langue. Un objet de traduction vide est également traité comme une suppression ; omettre la langue préserve sa valeur actuelle.
La langue par défaut est contrôlée selon l’opération, et non selon la clé. L’envoyer comme surcharge pour l’ÉCRIRE est rejeté ({"fr": {"label": "…"}} dans une organisation dont le français est la langue par défaut) — la langue par défaut doit se trouver à la racine. En revanche, {"fr": null} est accepté : cela SUPPRIME une surcharge dans cette langue. C’est important lorsqu’une organisation change de langue par défaut — une surcharge dans la nouvelle langue par défaut persiste dans les documents et prévaut sur la valeur racine lors de l’affichage ; sa suppression doit donc rester possible. Voir le schéma I18nOverlay.