Skip to main content
L’API Oxanaut est servie sur https://api.oxanaut.com. Toutes les routes sont préfixées par /v1.

Clés API

Créez une clé depuis le panel : Intégrations → API Oxanaut → Activer / Configurer. La clé commence par oxn_ et n’est affichée qu’une fois à la création.
Authorization
Exemple

Permissions

La permission est vérifiée côté serveur à chaque requête ; une clé read ne peut jamais modifier une ressource.
Une clé API donne accès aux données de votre compte au même titre qu’une session. Nommez chaque clé selon son usage, donnez-lui une date d’expiration quand c’est possible, et révoquez les clés inutilisées.

Conventions

  • Format : JSON sur toutes les routes (Content-Type: application/json).
  • Erreurs : format RFC 7807 simplifié — statusCode, message, éventuellement error.
  • Dates : ISO 8601 (UTC).
  • Montants : en centimes (totalCents: 363 = 3,63 €).

Périmètre des routes

La Référence API documente l’ensemble des routes par domaine : compte, services, facturation, boutique et panier, intégrations, notifications, affiliation, statut. Les routes /v1/admin/* et /v1/bot/* nécessitent des droits serveur ou un token bot et sont regroupées en fin de référence.