Límites y errores

Límites

Longitudes máximas

Campo
Longitud máxima por elemento
Cantidad máxima
subject
200 chars
-
recipients[]
-
1000
cc[]
-
10
bcc[]
-
10
name (from, to, cc, bcc)
100 chars
-
headers[]
-
10
headers[].key
900 chars
-
headers[].value
50 chars
-
tags[]
100 chars
10
batch_code
30 chars
-
content.html
300KB
content.text
300KB

Tamaño total por request

El tamaño total de cada request no puede superar los 10MB.

Tamaño de archivos adjuntos

Los archivos adjuntos se consideran como parte del mensaje, por lo que suman para el límite total de 10MB.

Errores

Si ocurrió algo que impidió completar con éxito un pedido, la respuesta tiene esta forma:
1
{
2
"success": false,
3
"error": {
4
"status": 403,
5
"type": "forbidden",
6
"message": "Origin IP address not allowed: 190.19.245.237"
7
}
8
}
Copied!

Tipos de errores

El type puede ser alguno de estos:
Status
error.type
Descripción
400
bad_request
El contenido del request tiene un formato inválido.
400
validation_error
Algunos de los campos tienen contenido inválido.
401
unauthorized
El API key utilizado es inválido o no se especificó.
403
forbidden
El request fue bloqueado. La causa se especifica en message.
500
internal_server_error
Ocurrió un error inesperado en el servidor.
503
service_unavailable
El servicio no está disponible. Generalmente por límites temporales de envío.

Límite alcanzado

En caso de alcanzar el límite mensual, el pedido será rechazadao, indicando un error de tipo 503 service_unavailable como este:
1
{
2
"success": false,
3
"error": {
4
"status": 503,
5
"type": "service_unavailable",
6
"message": "Sending limit reached: MONTHLY"
7
}
8
}
Copied!

Errores de validación

Cuando type es validation_error, se incluye un objeto errors con todos los errores de validación encontrados:
1
{
2
"success": false,
3
"error": {
4
"status": 400,
5
"type": "validation_error",
6
"message": "Some fields have invalid values"
7
"errors": {
8
"from.email": "required"
9
}
10
}
11
}
Copied!
Los tipos de error de validación pueden ser:
Error
Descripción
required
El campo es requerido.
required_at_least_one
Se debe incluir al menos un elemento en el campo de tipo array.
max_length_exceeded
Se excedió la longitud máximo en un campo de tipo string.
too_many_items
Se excedió la cantidad permitida de elementos en un campo de tipo array.
invalid_value
El valor indicado tiene un formato inválido.