Transmettre des commandes avec l’API et envoyer des invitations

POST https://api.trustsays.com/v1/orders avec du JSON dans le body :

• orderRef : votre numéro de commande.
• email : l’adresse e-mail du client.
• name : le nom du client, facultatif.
• status : paid, delivered, cancelled ou refunded.
• paidAt et deliveredAt : horodatages, facultatifs.
• locale : la langue et le pays du client, p. ex. fr-FR. Ce champ détermine la langue de l’invitation.

Chaque appel est envoyé avec trois en-têtes :

• X-TrustSays-Key : le préfixe de la clé, c’est-à-dire le texte entre ts_ et le trait de soulignement suivant.
• X-TrustSays-Timestamp : l’heure en secondes Unix.
• X-TrustSays-Signature : sha256= suivi du HMAC-SHA256 en hexadécimal de l’horodatage, d’un point et du body exact, calculé avec le secret de la clé.

Les appels datant de plus de 5 minutes sont refusés.

order vaut created ou updated. Le même numéro de commande envoyé à nouveau met la commande à jour. invitation indique ce qui s’est passé :

• scheduled : l’invitation est planifiée.
• not_delivered : la commande n’est pas encore livrée.
• not_in_plan : votre offre ne comprend pas d’invitations automatiques.
• quota : les invitations du mois sont épuisées.
• cancelled : commande annulée ou remboursée, aucune invitation n’est donc envoyée.
• duplicate, unsubscribed ou invalid_email : le client a déjà été invité, a refusé les e-mails, ou l’adresse e-mail est invalide.

• Ugyldig signatur (signature invalide) : signez le body exact que vous envoyez, et vérifiez la clé.
• Tidsstemplet er for gammelt (horodatage trop ancien) : vérifiez l’horloge du serveur.