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.sendcorex.comgraph.sendcorex.com

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 Developer
g.sendcorex.comUna por cuenta

Leer 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 Webmail

Mail & Graph

Enviar y gestionar

Una key de la página Developer funciona en mail.sendcorex.com y graph.sendcorex.com.

  1. 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. 2

    Crea una key

    Genera una nueva key allí y cópiala. Guárdala en un lugar seguro.

    Crear API key
  3. 3

    Envíala en cada solicitud

    Pásala en el header Authorization en mail.sendcorex.com y graph.sendcorex.com.

Header de la solicitud
Authorization: Bearer YOUR_API_KEY

Leer 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. 1

    Abrir Webmail

    Ve a webmail.sendcorex.com e inicia sesión con la cuenta de email que quieres leer.

    Abrir Webmail
  2. 2

    Ve a Configuración

    Abre la sección Configuración de esa cuenta de email.

  3. 3

    Genera la key

    Crea la API key allí y cópiala. Cada cuenta de email tiene la suya.

Primera solicitud
curl -s https://g.sendcorex.com/v1 \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"commands":[{"command":"list_folders"}]}'
Renovar el token
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ódigoHTTPCuándo
MISSING_AUTH_HEADER401La solicitud no tiene header Authorization.
INVALID_TOKEN401Formato incorrecto, token desconocido o revocado.
TOKEN_EXPIRED401El token ha caducado. Usa el refresh token.
RATE_LIMITED429Más de 15 solicitudes por segundo o 15 en curso.
AUTH_UNAVAILABLE503La autenticación no está disponible temporalmente.