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 / PATCH sur 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

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.