Retour

API RelayFinder

Documentation développeurs

Intégrez 37 500+ points relais dans votre e-commerce via une API REST simple et rapide.

Voir les tarifs

Démarrage rapide

bash
curl "https://www.relayfinder.fr/api/v1/relays?lat=48.8566&lng=2.3522&radius=5" \
  -H "X-API-Key: YOUR_API_KEY"

Authentification

X-API-Key

Méthode recommandée — passer la clé dans le header HTTP.

Authorization: Bearer <clé>

Alternative compatible avec les clients OAuth standards.

Paramètres

ParamètreTypeRequisDescription
latnumberRequisLatitude du centre de recherche
lngnumberRequisLongitude du centre de recherche
radiusnumberOptionnelRayon en km (défaut : 5, max : 50)
carriersstringOptionnelTransporteurs séparés par virgule : laposte, mondialrelay, vintedgo
limitnumberOptionnelNombre de résultats (défaut : 50, max : 500)

Réponse

json
{
  "relays": [
    {
      "id": "mr-001",
      "name": "Tabac Presse République",
      "carrier": "Mondial Relay",
      "address": "12 Place de la République",
      "city": "Paris",
      "postalCode": "75011",
      "latitude": 48.8635,
      "longitude": 2.3624,
      "distance": 0.8,
      "isOpen": true,
      "rating": 4.2,
      "reviewCount": 134
    }
  ],
  "total": 1,
  "lat": 48.8566,
  "lng": 2.3522,
  "radius": 5
}

Transporteurs supportés

La Poste

17 000+ relais Colissimo & Chronopost

carriers=laposte
Mondial Relay

12 000+ points relais en France

carriers=mondialrelay
Vinted Go

8 500+ casiers automatisés 24h/24

carriers=vintedgo

Limites par plan

PlanVolumeDébitSLA
Gratuit5 résultats
API Starter10 000/mois10 req/s99,5 %
API Growth100 000/mois50 req/s99,9 %
API ScaleIllimité200 req/s99,95 %

Voir tous les plans →

Gestion de votre clé API

La clé est stockée localement dans votre navigateur et jamais transmise à nos serveurs. Obtenir une clé API →