Intégrer

Suivi client

La page que voit votre client, ce qu'elle expose, et ce qu'elle n'expose jamais.

Deux publics, deux vues

Vue	Qui	Authentification	Contenu
Fiche d'envoi	Vous	Clé `pk_…`	Tout : prix, livreur mandaté, paiement, historique.
Suivi public	Votre client	Aucune	Les jalons, une estimation, le coursier mandaté.

Le suivi public

trackByCode prend le code de suivi à dix caractères communiqué au destinataire. Il n'exige aucune clé — c'est la vue destinée au client final.

Les SDK n'envoient pas votre clé sur cette surface. La poster sur un endpoint anonyme la ferait figurer dans des journaux d'accès qui ne sont pas les vôtres. Si vous appelez l'API à la main, ne mettez pas d'en-tête X-Api-Key ici.

La vue est expurgée : pas de téléphone de tiers, pas d'identifiant interne, pas de prix d'achat. Ce qu'elle porte est ce qu'un destinataire a besoin de savoir — où en est son colis, et qui va sonner à sa porte.

Vérifier le coursier à la porte

Le destinataire peut vérifier, depuis sa page de suivi, que la personne devant lui est bien celle mandatée pour ce colis. Le jeton présenté par le livreur ne vaut que pour son colis : présenté sur un autre suivi, il est refusé.

C'est une garantie que votre intégration n'a rien à implémenter, mais qu'il vaut mieux mentionner à vos clients : elle réduit les livraisons refusées par méfiance.

Afficher le suivi chez vous

createShipment rend l'URL publique de suivi. Deux usages :

la partager telle quelle (SMS, e-mail, page de confirmation) ;
l'encapsuler dans votre propre page, en appelant trackByCode côté serveur.

N'appelez pas trackByCode depuis le navigateur du client en boucle : le suivi public est limité par IP et par code, et un rafraîchissement agressif se fait refuser.

Ce qu'il ne faut pas afficher

Aucun identifiant technique. shp_7c1f4a2e n'a aucun sens pour un client. Affichez votre propre référence de commande.
Aucun statut brut. PICKUP_IN_PROGRESS n'est pas une phrase. Le suivi public rend des libellés destinés à être lus.