Utiliser l'integration API pour vos propres systemes - Intégrations

Utiliser l'integration API pour vos propres systemes - Intégrations | AutoLetter Help Center

Avec l'integration API, vous pouvez transmettre des commandes directement depuis votre propre systeme a AutoLetter. C'est ideal pour les developpements propres, les systemes de boutique personnalises ou les workflows automatises qui ne peuvent pas etre realises via les integrations standard (Billbee, Shopify).

Creer une integration

Rendez-vous dans Integrations, cliquez sur Ajouter et selectionnez API comme type d'integration.

Nommer l'integration

Donnez un nom explicite, par ex. « API Boutique propre » ou « Systeme ERP ».

Obtenir les identifiants

Apres la sauvegarde, vous recevez l'URL du point de terminaison API et pouvez generer un token JWT pour l'authentification.

Le token JWT pour l'authentification API est genere dans votre Workspace dans AutoLetter. Conservez ce token en securite et ne le partagez pas avec des personnes non autorisees.

Les commandes sont envoyees sous forme de tableau JSON par requete POST au point de terminaison API. L'authentification s'effectue via un token Bearer JWT dans l'en-tete Authorization.

curl -X POST https://api.autoletter.eu/v2/orders \
  -H "Authorization: Bearer VOTRE_TOKEN_JWT" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "OrderNumber": "ORD-2026-001",
      "OrderId": "12345",
      "Date": "2026-02-20T10:30:00Z",
      "Total": 89.99,
      "Address": {
        "FirstName": "Marie",
        "LastName": "Dupont",
        "Street": "Rue de la Paix",
        "HouseNumber": "42",
        "ZIP": "75002",
        "City": "Paris",
        "Country": "FR"
      }
    }
  ]'

Chaque commande doit contenir les champs suivants :

Champ	Type	Description
`OrderNumber`	String	Le numero de commande
`OrderId`	String	Un ID de commande unique
`Date`	String (ISO 8601)	La date de la commande
`Total`	Number	Le montant total de la commande
`Address`	Object

L'objet Address contient l'adresse de livraison et doit inclure au minimum le nom, la rue, le code postal, la ville et le pays.

En plus des champs obligatoires, vous pouvez transmettre les champs optionnels suivants :

Champ	Type	Description
`ExternalId`	String	ID de reference externe de votre systeme
`ShopId`	String	Identifiant de boutique pour le fonctionnement multi-boutiques
`InvoiceAddress`	Object	Adresse de facturation differente
`LetterAddress`	Object	Adresse differente pour l'envoi de lettres
`Products`

Par defaut, seules les nouvelles commandes sont creees. Si vous souhaitez mettre a jour des commandes existantes, ajoutez le parametre allowUpdates a votre requete :

{
  "allowUpdates": true,
  "orders": [...]
}

Avec allowUpdates active, les commandes avec un OrderId correspondant sont mises a jour au lieu d'etre rejetees.

Contrairement a Billbee et Shopify, il n'y a aucun delai de synchronisation avec l'integration API. Les commandes envoyees par API sont immediatement disponibles dans AutoLetter et peuvent etre directement utilisees dans les campagnes.

L'API renvoie des codes de statut HTTP standardises :

200 OK -- Commandes traitees avec succes
400 Bad Request -- Donnees erronees (details dans le corps de la reponse)
401 Unauthorized -- Token JWT invalide ou manquant
429 Too Many Requests -- Limite de requetes atteinte

En cas d'erreur, la reponse contient des informations detaillees sur les enregistrements concernes.