Localisation des points de vente

API de localisation des points de vente Nirio.

Usage typique

Cette API est pensée pour orienter un client vers un point de dépôt ou de retrait proche de sa position.

Endpoint

GET /v1/point-of-sales

Authentification

Même mécanisme d'authentification que les autres APIs partenaires.

Réponse

Points de vente, horaires d'ouverture et offres de service disponibles.

Objectif

Cette API permet de récupérer la liste des points de vente FDJ agréés Nirio les plus proches d'une position géographique.

Elle peut être utilisée pour orienter un client vers un point de dépôt ou de retrait.

API

GET /v1/point-of-sales

Authentification

Cette API utilise la même authentification que les autres APIs partenaires.

Tester la requête

GET
/v1/point-of-sales

Récupère la liste des points de vente FDJ agréés Nirio les plus proches d'une position géographique.

Authorization

BasicAuth
AuthorizationBasic <token>

In: header

Query Parameters

radiusInMeters*integer

Rayon de recherche en mètres. La valeur doit être strictement positive.

Range1 <= value
latitude*number

Latitude du point de recherche.

Formatdouble
Range-90 <= value <= 90
longitude*number

Longitude du point de recherche.

Formatdouble
Range-180 <= value <= 180
limit?integer

Nombre maximum de points de vente retournés.

Range1 <= value <= 100
Default20
offset?integer

Décalage de pagination.

Range0 <= value
Default0

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/point-of-sales?radiusInMeters=5000&latitude=48.8566&longitude=2.3522&limit=20&offset=0"
[  {    "id": "123456",    "name": "TABAC DE LA GARE",    "address": "10 rue de Paris, 75010 Paris",    "latitude": 48.8765,    "longitude": 2.3591,    "openingTimes": [      {        "day": 1,        "slots": [          {            "start": "08:00",            "end": "12:30"          },          {            "start": "14:00",            "end": "19:00"          }        ]      }    ],    "serviceOffers": [      {        "id": "10",        "label": "Encaissement de factures"      }    ]  }]

Correspondance des jours

  • 0 : dimanche
  • 1 : lundi
  • 2 : mardi
  • 3 : mercredi
  • 4 : jeudi
  • 5 : vendredi
  • 6 : samedi

Remarques

  • La réponse est une liste simple, sans nextCursor ni total
  • L'API ne retourne pas la distance au point de recherche
  • Le périmètre de services disponibles sur un point de vente est renvoyé dans serviceOffers

Documentation partenaires Nirio

Intégration des services de dépôt, retrait et localisation des points de vente.

Introduction

Introduction dépot