Vue d'ensemble
Créer, télécharger, suivre et annuler des bordereaux depuis vos systèmes.
Le type de client et le contrat — qui engagent juridiquement — restent gérés depuis le dashboard.
Aucun environnement de test
Toute clé API est une clé de production ; il n'existe aucun sandbox. Un appel réussi à POST /shipping crée un bordereau réel, débite votre portefeuille et déclenche la recherche d'un livreur.
Le préfixe sk_test_ de certaines anciennes clés n'est qu'une étiquette : ces clés créent également des envois réels.
Pour valider votre intégration, utilisez vos propres adresses et annulez le bordereau tant qu'il est au statut created.
URL de base
https://api.arelpro.com/pro/api/v1
Le préfixe /pro/api/v1 fait partie de l'URL. Toutes les routes de cette page sont relatives à cette base.
Intégrations existantes. L'ancien hôte https://api.pro.arelapp.com reste servi à l'identique, sans date de fin : mêmes routes, mêmes clés, mêmes réponses. Aucune migration n'est requise. api.arelpro.com est le nom recommandé pour les nouvelles intégrations.
Les URL de PDF ne suivent pas votre base. Elles sont renvoyées absolues et pointent toujours vers https://api.arelpro.com/pdfs/…, quel que soit l'hôte appelé — api.pro.arelapp.com inclus. Ce n'est pas une anomalie. Les deux hôtes servant /pdfs/, un lien PDF plus ancien reste valide.
Règle : utilisez l'URL telle qu'elle est fournie. Ne la reconstituez pas à partir de votre base, n'en extrayez pas le chemin pour le recoller ailleurs, et ne codez pas l'hôte en dur. C'est la seule façon de rester insensible à ce décalage d'hôte.
En résumé
- Authentification — clé API + Client ID en en-têtes. Les deux doivent appartenir au même compte.
- Limites — 60 req/min, 1 000/heure, 10 000/jour par clé.
- Webhooks — 5 événements, signature HMAC-SHA256, 3 tentatives.