Jusqu'ici, l'API répondait à des questions sur des données publiques : cette adresse existe-t-elle, quelles adresses autour de ce point, quelle entreprise à ce SIRET. Une question revenait pourtant régulièrement, et elle portait sur des données qui ne sont pas publiques : les vôtres.
« Quel est mon point de vente le plus proche de ce client ? »
C'est ce que « Mes lieux » vient couvrir. Vous déposez chez nous votre référentiel de sites — boutiques, restaurants, agences, points de retrait, casiers — et vous cherchez dedans avec le même moteur d'adresses que le reste de l'API.
Deux façons de l'alimenter
Depuis votre espace client, si votre réseau tient sur quelques dizaines de points : un éditeur avec une carte, la fiche de chaque site, ses horaires hebdomadaires et ses exceptions (fermeture annuelle, jour férié), et la possibilité de corriger un géocodage en déplaçant le marqueur quand la résolution automatique tombe à côté.
Par API, si votre source de vérité est ailleurs — un ERP, un back-office métier, un fichier maison. Trois chemins d'écriture :
PUT/PATCHsur un site désigné par votre identifiant (id_externe) — vous n'avez donc aucun identifiant TrustyData à stocker de votre côté ;sites:lot— jusqu'à 1 000 sites en un appel. Une ligne invalide n'annule pas les autres : le rapport dit ce qui est passé et nomme ce qui a échoué ;sites:sync— votre export fait autorité, ce qui n'y figure pas est désactivé.
Sur ces trois chemins, une écriture = un appel compté, quel que soit le nombre de sites qu'elle porte.
Le géocodage se fait tout seul
Un site peut être poussé sans coordonnées : donnez l'adresse, elle est géocodée en tâche de fond, et le site devient cherchable une fois résolu. Vous n'avez pas à enchaîner un appel de géocodage puis une écriture.
Chaque écriture en masse rend un tache_id : GET /locations/taches/{id}
relit le rapport plus tard — ce qui est passé, la liste nommée des échecs.
C'est le reçu d'une écriture déjà payée, donc non facturé, et il reste
lisible même si votre quota est épuisé.
Chercher dedans
curl -s -G "https://api.trustydata.app/services/v1/locations/search" \
-H "Authorization: Bearer VOTRE_CLE" \
--data-urlencode "referentiel=boutiques" \
--data-urlencode "adresse=12 rue de la République, Lyon" \
--data-urlencode "rayon=10"
Le centre se donne au choix par lat+lon, par une adresse libre, ou par un
simple nom de commune ou code postal — utile quand tout ce que vous avez
d'un prospect, c'est sa ville. La réponse dit lequel des trois cas s'applique
(point_central.precision vaut coordonnees, adresse ou commune) : un
rayon de 2 km n'a pas le même sens autour d'un numéro de rue et autour du
centre d'une grande ville, et vous avez de quoi le savoir.
Les résultats sortent triés du plus proche au plus lointain, chacun avec sa
distance_m et son bloc ouverture calculé dans le fuseau du site —
ouvert ou fermé maintenant, prochaine ouverture, prochaine fermeture. De quoi
répondre « la boutique la plus proche et ouverte » sans rejouer les
horaires vous-même.
Le rayon va de 1 à 50 km, la pagination rend 100 résultats par page (jusqu'à 200).
Deux garde-fous qu'on assume
Une synchronisation ne supprime jamais, elle désactive — et un export qui
ramène un site le réactive. Mieux : une sites:sync qui désactiverait plus
de la moitié de vos sites actifs est refusée en 409, avec le nombre avant
et après. Renvoyez avec confirmer_reduction: true si c'est voulu. C'est le
filet contre l'export tronqué qui part en production un vendredi soir.
La capacité est un refus chiffré, pas un dépassement silencieux. Votre plan
inclut un nombre de sites — 200 / 2 000 / 10 000 selon Starter / Growth /
Business, avec une tolérance de 10 %. Au-delà, l'écriture est refusée en 409
en vous donnant vos sites_actifs, votre capacite et le plafond toléré.
Aucune facturation au site : on préfère un mur visible à une facture
surprise.
Disponibilité
« Mes lieux » est ouvert à partir du plan Starter. Les étiquettes (tags,
conjonctives : le site doit toutes les porter) et les distances routières
demandent Growth.
La documentation
- Le guide : https://trustydata.fr/docs/lieux.html
- L'éditeur de l'espace client : https://trustydata.fr/docs/espace-client/lieux/
- La référence complète des endpoints
/locations/*: https://trustydata.fr/docs/
Dites-nous
- Comment vivent vos points de vente aujourd'hui — un export ERP, un Google Sheet, un CMS ? C'est ce qui décidera des prochains formats d'import.
- Le découpage en référentiels (plusieurs listes distinctes par compte) correspond-il à votre organisation, ou vous faudrait-il autre chose ?
- Qu'est-ce qui vous manque le plus sur la fiche d'un site ?
Vos retours passent par la page de contact.