Aller au contenu

Intégrations API v1

API et MCP

Ajoute des destinataires au carnet et génère des étiquettes depuis un script ou un client MCP. Essaie les requêtes sur ton éditeur local.

GET/api/v1/destinations

Lister les destinations

Récupère les fiches du carnet. Le filtre Amazon affiche Satolas et Longvic. Utilise le champ id ou slug dans tes requêtes d’export.

POST/api/v1/destinations/suggest

Suggérer une destination

Pour un suivi Mondial Relay, l’API ne cherche que dans le HUB encodé. Elle privilégie le suivi enregistré, puis la même tournée, puis les autres fiches du HUB.

auto_select_id contient l’identifiant d’une correspondance unique par suivi ou tournée. S’il vaut null, choisis une fiche parmi les résultats. Avec un suivi Amazon, choisis Satolas ou Longvic, car les 10 chiffres ne contiennent pas le HUB.

GET/api/v1/destinations/discover

Chercher une entreprise ou un site

Indique un nom public, un lieu, un SIRET ou un code postal. Vérifie l’adresse et la source, puis renseigne l’agence et la tournée avant d’ajouter la fiche au carnet.

existing_destinations liste les fiches du carnet dont la rue, le code postal et la ville correspondent au site. Plusieurs fiches peuvent partager la même adresse. Choisis celle qui correspond au destinataire et à la tournée.

POST/api/v1/destinations

Ajouter une fiche

name nomme la fiche. address contient une à trois lignes imprimées, dans l’ordre. Le code pays est facultatif et vaut FR par défaut.

201 indique une création. 200 renvoie la fiche existante si les lignes imprimées, le pays, l’agence et la tournée correspondent. La fiche conserve son identifiant et ses données. Un destinataire imprimé ou un routage différent donne une fiche distincte.

Remplace les données d’exemple avant d’envoyer la requête pour ajouter une vraie destination.

POST/api/v1/labels

Générer un PNG

Envoie le suivi sous forme de chaîne. Pour Amazon, utilise 10 chiffres et choisis Satolas ou Longvic. Pour Mondial Relay, utilise 26 chiffres et l’identifiant d’une fiche.

Tu peux envoyer "destination": "auto" si tu veux utiliser une correspondance unique. Une réponse 422 destination_choice_required indique qu’il faut consulter les suggestions et choisir la fiche.

Tu peux fournir sender avec les champs name, street et city. La réponse contient le PNG et l’en-tête X-Tracking-Number.

POST/api/v1/labels/batch

Exporter un ZIP

Envoie de 1 à 50 suivis distincts au même format. Les PNG partagent le destinataire et reçoivent chacun un expéditeur différent.

Réutilise la même chaîne sender_seed pour retrouver ces expéditeurs lors d’un nouvel export du même lot.

Connecter un client MCP

Colle cette configuration dans ton client MCP et renseigne le chemin de ta copie locale de mcp_server.py.

Configuration MCP
{
  "mcpServers": {
    "mrnew": {
      "command": "python3",
      "args": [
        "/chemin/vers/mrnew/mcp_server.py"
      ],
      "env": {
        "MRNEW_API_URL": "https://mrnew-45-141-215-78.nip.io"
      }
    }
  }
}
  • list_destinations Liste le carnet.
  • suggest_destinations Propose des fiches à partir d’un suivi.
  • discover_destinations Cherche des adresses publiques et les fiches du carnet au même site.
  • add_destination Ajoute ou réutilise une fiche. Le champ created indique le résultat.
  • generate_label Enregistre un PNG.
  • generate_label_batch Enregistre un ZIP.

Les fichiers sont enregistrés localement dans output/mcp par défaut.

Codes d’erreur

400
Requête mal formée.
404
Destination introuvable.
422
Suivi, format ou données incompatibles.
500
Échec du traitement.
502
Sources d’adresses publiques indisponibles.

Le JSON d’erreur contient error.code et error.message. Dans un lot, error.details peut indiquer la ligne à corriger.