Oquira BusinessGérez les emplacements physiques de votre entreprise et leurs détails.
Les emplacements représentent les points de présence physiques (magasins, agences, cliniques) où les services sont fournis aux clients.
Définissez un nouvel emplacement physique pour votre organisation.
POST /v1/locations
X-API-Key: votre_cle_api
Content-Type: application/json
{
"organizationId": "org_123...",
"name": "Boutique Paris Centre",
"address": "123 Champs-Élysées, 75008 Paris, France",
"latitude": 48.8738,
"longitude": 2.2950,
"phone": "+33123456789",
"email": "paris@monentreprise.com",
"timezone": "Europe/Paris"
}| Propriété | Type | Requis | Description |
|---|---|---|---|
name | string | Oui | Nom de l'emplacement. |
address | string | Oui | Adresse physique complète. |
latitude | number | Oui | Latitude WGS84. |
longitude | number | Oui | Longitude WGS84. |
timezone | string | Non | Fuseau horaire (ex: Europe/Paris, UTC). |
Récupérez tous les emplacements appartenant à votre organisation.
GET /v1/business/locations
X-API-Key: votre_cle_apiRecherchez des emplacements au sein d'une organisation par nom ou adresse.
GET /v1/locations/search?organizationId={organizationId}&q=Paris
X-API-Key: votre_cle_apiTrouvez des emplacements dans un rayon spécifique autour de coordonnées.
GET /v1/locations/nearby?lat=48.8&lon=2.3&radiusKm=5
X-API-Key: votre_cle_api| Paramètre | Type | Requis | Description |
|---|---|---|---|
lat | number | Oui | Latitude centrale. |
lon | number | Oui | Longitude centrale. |
radiusKm | number | Oui | Rayon de recherche en kilomètres. |
limit | number | Non | Nombre maximal de résultats. |
Modifiez les détails d'un emplacement physique existant.
PATCH /v1/locations/{locationId}
X-API-Key: votre_cle_api
Content-Type: application/json
{
"name": "Galerie Paris",
"phone": "+33100000000"
}Supprimez définitivement un emplacement. Cela affectera également les services et les files d'attente liés à cet emplacement.
DELETE /v1/locations/{locationId}
X-API-Key: votre_cle_api