Te explicamos como utilizar os formularios mediante Rest API.
Con nuestra Rest API de formularios podrás obtener los formularios diseñados en tu cuenta.
Los endpoints a continuación son públicos, es decir, se antepone /public/ como medio diferenciador de endpoints privados.
Para renderizar los formularios te sugerimos utilizar nuestro SDK de formulario.
Formato
Nuestros formularios están cuidadosamente diseñados para presentar un formato amigable y flexible al mismo tiempo.
Todos los formularios que se envíen deben tener el siguiente esquema:
[{"_id":String,"value":String||Array||Number}]
Dentro de este Array debes añadir el listado de campos con su _id y value, siendo este último capaz de recibir tres tipos de datos: String, Number y Array.
El ID debe coincidir con los valores que se entregan al obtener un formulario, es decir, con el campo _id.
Debes considerar que los valores deben coincidir con los configurados en tu cuenta, sobre todo para los casos de selección única o múltiple.
Contamos con 3 niveles de validación:
Tipo de dato corresponde con el tipo de campo
Validación del valor por campo (built-in y/o personalizado)
Verificación de restricciones (máximo, mínimo, longitud, etc)
{
"name": "BadRequest",
"message": "Some element not as field, please check or try again",
"code": 400,
"className": "bad-request",
"data": "Maybe the organization has changed the form and you're submit is not valid anymore.",
"errors": {}
}
{
"name": "BadRequest",
"message": "The maximum of value is 10 for element \"62703d9d3cf0565020ec9e3c\".",
"code": 400,
"className": "bad-request",
"errors": {}
}
{
"name": "BadRequest",
"message": "The element form \"videsk_essential\" is required, never delete.",
"code": 400,
"className": "bad-request",
"errors": {}
}
{
"name": "BadRequest",
"message": "Please provide a valid \"token\", is mandatory.",
"code": 400,
"className": "bad-request",
"errors": {}
}
{
"name": "BadRequest",
"message": "Please check the segment id provided.",
"code": 400,
"className": "bad-request",
"errors": {}
}
{
"name": "BadRequest",
"message": "Provide a valid \"type\" form submission.",
"code": 400,
"className": "bad-request",
"errors": {}
}
{
"name": "NotFound",
"message": "Not form found in segment provided.",
"code": 404,
"className": "not-found",
"errors": {}
}
