Oquira BusinessGérez le profil, les paramètres et les détails commerciaux de votre organisation.
Les organisations sont l'entité principale d'Oquira. Elles représentent votre entreprise et contiennent toutes les autres ressources telles que les emplacements, les services et les files d'attente.
Créez une nouvelle organisation et devenez-en le propriétaire.
POST /v1/organizations
X-API-Key: votre_cle_api
Content-Type: application/json
{
"name": "Mon Entreprise",
"slug": "mon-entreprise",
"type": "retail",
"description": "Services de vente au détail premium"
}| Propriété | Type | Requis | Description |
|---|---|---|---|
name | string | Oui | Le nom officiel de votre entreprise. |
slug | string | Oui | Identifiant unique pour l'URL. Lettres minuscules, chiffres et tirets uniquement. |
type | string | Non | Catégorie : retail, healthcare, banking, government, other. |
description | string | Non | Courte description de l'entreprise. |
Récupérez toutes les organisations dont l'utilisateur authentifié est membre.
GET /v1/organizations
X-API-Key: votre_cle_apiMettez à jour les détails commerciaux de votre organisation. Des champs tels que legalName (nom légal), siret et vatNumber (numéro de TVA) sont essentiels pour la vérification de l'entreprise.
PATCH /v1/organizations/{organizationId}
X-API-Key: votre_cle_api
Content-Type: application/json
{
"name": "Mon Entreprise Mise à Jour",
"legalName": "Mon Entreprise SAS",
"website": "https://monentreprise.com",
"billingEmail": "billing@monentreprise.com",
"availabilityRadiusKm": 2
}| Propriété | Type | Description |
|---|---|---|
name | string | Nom d'affichage public. |
legalName | string | Raison sociale légale de l'entreprise. |
website | string | URL du site web officiel. |
billingEmail | email | Email de contact pour les factures. |
availabilityRadiusKm | number | Distance max pour rejoindre via mobile (0.1, 0.3, 0.5, 1, 2, 5, 10). |
Supprimez définitivement une organisation et toutes les données associées (emplacements, services, membres, etc.).
DELETE /v1/organizations/{organizationId}
X-API-Key: votre_cle_apiTransférez la propriété de l'organisation à un autre membre. L'ancien propriétaire deviendra un Administrateur.
POST /v1/organizations/{organizationId}/transfer-ownership
X-API-Key: votre_cle_api
Content-Type: application/json
{
"newOwnerId": "user_456..."
}