Centre développeur

Documentation de l’API Once Email

Documentation publique pour les tests automatisés : authentification, quotas, erreurs et règles d’usage.

La documentation est publique. Les clés API exigent un abonnement Developer actif et se gèrent dans le tableau de bord.
Authentification

Envoyez Authorization: Bearer oe_live_… avec chaque requête. La clé n’est montrée qu’une fois ; gardez-la dans un gestionnaire de secrets, jamais dans le navigateur, les journaux ou Git.

Authorization: Bearer oe_live_your_key
Parcours type
  1. 1Créez une boîte temporaire et conservez son identifiant.
  2. 2Demandez à votre système de test d’envoyer un e-mail.
  3. 3Interrogez la liste avec temporisation ; évitez les requêtes vides rapides.
  4. 4Lisez le message, terminez les assertions puis supprimez la boîte.

Endpoints de la bêta privée

POST /v1/inboxesGET /v1/inboxes/{inboxId}/messagesGET /v1/inboxes/{inboxId}/messages/{uid}GET /v1/inboxes/{inboxId}/messages/{uid}/attachments/{cid}DELETE /v1/inboxes/{inboxId}

Codes d’état

400

Requête invalide

401

Clé absente ou invalide

403

Offre ou ressource refusée

404

Ressource introuvable

429

Limite ou quota mensuel atteint

5xx

Défaillance temporaire du service

Disponibilité des clients

Les outils de test TypeScript et un client Python disposent d’une base implémentée. Aucun paquet public installable ni SDK tous langages n’est encore proposé.

État de la facturation

Developer utilise un abonnement Stripe mensuel et un quota API mensuel. Aucun solde rechargeable. Le paiement Live reste fermé jusqu’aux tests de paiement et de remboursement.

Usage autorisé

Utilisez l’API uniquement sur des systèmes que vous êtes autorisé à tester. Spam, contournement, abus de comptes, surveillance d’autrui et conservation prolongée de données personnelles sont interdits.

L’API se prépare à la production
Le contrat est publié d’abord. Clés et appels réels ne seront ouverts qu’après validation des webhooks, quotas et régressions.
Voir les tarifs