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.
/api/v1/destinationsLister 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.
/api/v1/destinations/suggestSuggé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.
/api/v1/destinations/discoverChercher 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.
/api/v1/destinationsAjouter 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.
/api/v1/labelsGé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.
/api/v1/labels/batchExporter 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.
{
"mcpServers": {
"mrnew": {
"command": "python3",
"args": [
"/chemin/vers/mrnew/mcp_server.py"
],
"env": {
"MRNEW_API_URL": "https://mrnew-45-141-215-78.nip.io"
}
}
}
}
list_destinationsListe le carnet.suggest_destinationsPropose des fiches à partir d’un suivi.discover_destinationsCherche des adresses publiques et les fiches du carnet au même site.add_destinationAjoute ou réutilise une fiche. Le champcreatedindique le résultat.generate_labelEnregistre un PNG.generate_label_batchEnregistre 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.