Centro para desarrolladores

Documentación de la API de Once Email

Documentación pública para pruebas automatizadas de correo: autenticación, cuotas, errores y uso seguro.

La documentación es pública. Las claves API solo están disponibles con una suscripción Developer activa y se gestionan en el panel.
Autenticación

Envía Authorization: Bearer oe_live_… en cada solicitud. La clave se muestra una vez; guárdala en un gestor de secretos, nunca en código del navegador, registros o Git.

Authorization: Bearer oe_live_your_key
Flujo habitual
  1. 1Crea un buzón temporal y conserva su ID.
  2. 2Haz que tu sistema de prueba envíe un correo a esa dirección.
  3. 3Consulta la lista con espera progresiva; evita consultas vacías rápidas.
  4. 4Lee el mensaje objetivo, completa las aserciones y elimina el buzón.

Endpoints de Beta privada

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

Códigos de estado

400

Solicitud no válida

401

Clave ausente o no válida

403

Plan o recurso denegado

404

Recurso no encontrado

429

Límite de frecuencia o cuota mensual

5xx

Fallo temporal del servicio

Disponibilidad de clientes

Las herramientas de prueba TypeScript y un cliente Python tienen una base implementada. Aún no se ofrece un paquete público instalable ni un SDK para todos los lenguajes.

Estado de facturación

Developer usa suscripción mensual de Stripe y cuota API mensual. No se ofrece saldo recargable. El pago Live sigue cerrado hasta superar las pruebas de pago y reembolso.

Uso permitido

Usa la API solo en sistemas que estés autorizado a probar. Se prohíben spam, evasión de políticas, abuso de cuentas, vigilancia de comunicaciones ajenas y conservación prolongada de datos personales.

La API se prepara para producción
Primero se publica el contrato. Las claves y llamadas reales se abrirán solo después de validar webhooks de pago, cuotas y regresiones.
Ver precios