Contacts : contacts
Mettre à jour des contacts
Modifiez des contacts existants, jusqu'à 500 par commande. Mêmes arguments qu'Upsert Contacts, mais ne crée jamais : un email qui n'est pas un contact échoue avec NOT_FOUND.
https://g.sendcorex.com/v1/contactscommand: update_contactsNécessite le scope contact:update sur votre API key.
Utilisez-le quand votre application ne doit toucher que des personnes déjà contacts, par exemple un formulaire de profil qui ne doit pas ajouter d'inconnus.
Arguments
contactsobject[]obligatoireDe 1 à 500 lignes avec un
emailet les parties à modifier. Mêmes champs qu'Upsert Contacts.list_idstringfacultatifAjoute aussi tous les contacts de cette commande à cette liste.
tagsstring[]facultatifTags ajoutés à tous les contacts de cette commande.
return_contactsbooleanfacultatifAjoute à chaque élément le contact complet après la modification.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/contacts',
{
commands: [
{
command: "update_contacts",
args: {
contacts: [
{
email: "ana@acme.com",
last_name: "Costa",
fields: {
plan: "business"
}
}
]
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "update_contacts",
"id": "0",
"type": "SUCCESS",
"took_ms": 14,
"data": {
"items": [
{
"id": "ana@acme.com",
"ok": true,
"data": {
"created": false,
"changed": true
}
}
],
"ok_count": 1,
"failed_count": 0,
"created": 0,
"updated": 1,
"unchanged": 0
}
}
]
}Champs de la réponse
items[].data.changedfalsequand le contact avait déjà ces valeurs.updated / unchangedCombien de contacts ont changé et combien étaient déjà à jour.
createdvaut toujours0.ok_count / failed_countCombien de lignes ont réussi et combien ont échoué.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
MISSING_SCOPEL'API key n'a pas le scope requis par cette commande. Les autres commandes de la requête s'exécutent quand même.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide : email, valeur de champ, option d'enum, clé de where, id de liste…
- CMD
NOT_FOUNDLe contact, la liste, le champ ou le segment n'existe pas.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.