Errores de la API

Esta página enumera todos los errores que devuelven los endpoints POST /v1/events/send y POST /v1/links/generate/{prjId} de la API de Pristo, con el mensaje del cuerpo y la solución.

Cómo son los errores

• La mayoría de los errores 400 y 404 tienen un cuerpo de texto sin formato, por ejemplo contact is required. No es JSON, así que léelo como texto.
• Los errores 401 y 415, algunos 400 y la mayoría de los 500 tienen un cuerpo de problema JSON (Content-Type: application/problem+json) con title y status. Un 500 puede agregar un mensaje detail.
• La API revisa la solicitud en este orden: la ruta, el cuerpo, la clave API y luego los datos. Una solicitud con varios problemas devuelve solo el primero.

Errores en ambos endpoints

Estado	Cuerpo	Causa	Solución
400	Cuerpo de problema JSON, title Bad Request	Falta el cuerpo o no es JSON válido, o un campo tiene el tipo JSON incorrecto, como "isReusable": "true"	Envía un objeto JSON. Envía {} cuando no tengas campos que definir
400	Payload size exceeds the maximum allowed size of 10000 bytes	El cuerpo ocupa más de 10 000 bytes	Envía menos campos personalizados o campos más cortos
400	Value is invalid	El valor de X-API-Key tiene menos de 24 caracteres. En los eventos, type o contact.id solo tiene espacios. En los enlaces, language no es un código ISO 639-1	Copia la clave completa. Corrige el campo
401	Cuerpo de problema JSON, title Unauthorized	Falta el encabezado X-API-Key o está vacío, o la clave es incorrecta, está desactivada o se eliminó	Envía una clave activa. Consulta Autenticarse con una clave API
405	Vacío	La solicitud no usó POST	Envía POST
415	Cuerpo de problema JSON, title Unsupported Media Type	El encabezado Content-Type no es application/json	Agrega Content-Type: application/json
500	Internal server error o un cuerpo de problema JSON	Algo falló del lado de Pristo	Espera y vuelve a intentarlo. Si el error continúa, comunícate con el soporte de Pristo

Enviar un evento

Estado	Cuerpo	Causa	Solución
400	contact is required	El cuerpo no tiene un objeto contact	Agrega contact con al menos id
400	type is required and must be between 1 and 50 characters long	Falta type, está vacío o tiene más de 50 caracteres	Envía el Identificador único del tipo de evento
400	contact.id is required and must be between 1 and 50 characters long	Falta contact.id, está vacío o tiene más de 50 caracteres	Envía tu ID del contacto
404	no population is associated with this api key	El programa de la clave API no tiene población	Crea la población del programa o usa una clave de un programa que tenga una
404	Population with id not found	No se encontró la población del programa al guardar el evento	Revisa la población en la aplicación y vuelve a intentarlo

Generar un enlace de encuesta

Estado	Cuerpo	Causa	Solución
400	provided surveyId is not valid	El prjId de la ruta no es un ID de cuestionario de 22 caracteres. Un UUID completo también falla	Copia el ID desde la pestaña Compartir del cuestionario
400	expiresInMinutes must be between 1 and 1576800	expiresInMinutes es menor que 1 o mayor que 1 576 800	Envía un valor de 1 a 1 576 800 o no lo incluyas para que el enlace no caduque
400	language must be exactly 2 characters long (iso 639-1)	language no tiene 2 caracteres	Envía un código como en o he
400	title must be at most 50 characters long	title tiene más de 50 caracteres	Acorta el título
400	customField values must be strings	Un valor de customFields es un número, un booleano, un objeto o un arreglo	Envía todos los valores como cadenas
400	customField keys and values must be at most 50 characters long	Una clave o un valor de customFields tiene más de 50 caracteres	Acórtalo
404	project with id <UUID> not found	No hay ningún cuestionario con este ID en la cuenta de la clave API, o el cuestionario se eliminó	Revisa el ID y la cuenta de la clave
500	Cuerpo de problema JSON, detail project does not have a form associated	El cuestionario no tiene formulario	Comunícate con el soporte de Pristo e indica el ID del cuestionario
500	Cuerpo de problema JSON, detail a problem occurred, please try again later	No se pudo cargar el cuestionario	Espera y vuelve a intentarlo

Temas relacionados

• Introducción a la API de Pristo
• Enviar un evento
• Generar un enlace de encuesta
• Referencia de la API (en inglés)