Primeros pasos
Crea una API key
Enviar y gestionar usan una key. Leer emails usa otra, creada en otro lugar. Elige la que encaje con lo que estás construyendo.
¿Qué key necesitas?
Mail & Graph
Enviar y gestionar
Para enviar email y para todo lo demás de la API: dominios, contactos, seguimiento, remitentes y logs.
Se crea en
Dashboard, página Developer
Abrir la página DeveloperLeer emails
Leer un buzón
Para leer, buscar y organizar los emails de una cuenta de email.
Se crea en
Webmail, Configuración de cada cuenta de email
Abrir WebmailMail & Graph
Enviar y gestionar
Una key de la página Developer funciona en mail.sendcorex.com y graph.sendcorex.com.
- 1
Abre la página Developer
Inicia sesión en app.sendcorex.com y ve a la página Developer del dashboard.
Abrir página Developer - 2
- 3
Envíala en cada solicitud
Pásala en el header Authorization en mail.sendcorex.com y graph.sendcorex.com.
Authorization: Bearer YOUR_API_KEYLeer emails
Leer un buzón
Estas keys se crean dentro de Webmail, una por cada cuenta de email, y se usan en g.sendcorex.com.
- 1
Abrir Webmail
Ve a webmail.sendcorex.com e inicia sesión con la cuenta de email que quieres leer.
Abrir Webmail - 2
Ve a Configuración
Abre la sección Configuración de esa cuenta de email.
- 3
Genera la key
Crea la API key allí y cópiala. Cada cuenta de email tiene la suya.
curl -s https://g.sendcorex.com/v1 \
-H "Authorization: $TOKEN" \
-H "Content-Type: application/json" \
-d '{"commands":[{"command":"list_folders"}]}'curl -s https://g.sendcorex.com/v1/token/refresh \
-H "Content-Type: application/json" \
-d "{\"refresh_token\":\"$REFRESH\"}" Envía el token como Authorization: <token> o Authorization: Bearer <token>. Los tokens empiezan por S.C.G. y el refresh token por R.S.C.G.
Un buzón por key
La key decide de quién son los emails que lees. Ningún argumento en la solicitud puede elegir otro dueño.
Los tokens expiran
Un token expirado devuelve TOKEN_EXPIRED. Rota el par con Refresh Token. El refresh token que usaste deja de funcionar al instante.
Keys revocadas
Un token se guarda en caché hasta 1 hora, así que un token revocado puede seguir funcionando hasta que expire esa caché.
Rate limit
15 solicitudes por segundo y 15 a la vez, por IP y buzón. Por encima recibes 429 RATE_LIMITED con un header Retry-After.
Errores de autenticación
Lo que devuelve la API de lectura de emails cuando el problema es la key.
| Código | HTTP | Cuándo |
|---|---|---|
MISSING_AUTH_HEADER | 401 | La solicitud no tiene header Authorization. |
INVALID_TOKEN | 401 | Formato incorrecto, token desconocido o revocado. |
TOKEN_EXPIRED | 401 | El token ha caducado. Usa el refresh token. |
RATE_LIMITED | 429 | Más de 15 solicitudes por segundo o 15 en curso. |
AUTH_UNAVAILABLE | 503 | La autenticación no está disponible temporalmente. |