Saltar al contenido principal

HTTP Headers

Esta sección describe las cabeceras HTTP que la API aceptará de cualquier solicitud.

Tipo de contenido​

Todas las solicitudes deben contener un encabezado HTTP content-type.

Tipos de contenido aceptados​

Formato baseTipos de contenidoTipos de contenido
JSONapplication/jsontext/json no es actualmente un tipo de contenido aceptado
Datos del formulariomultipart/form-dataSólo se utiliza al cargar variaciones

Errores de tipo de contenido​

Código de respuestaNotas
400Se ha entendido el tipo de contenido pero no se ha podido descodificar. Aparecerá más información en el cuerpo de la respuesta
415Falta el tipo de contenido o no es compatible

Nota: En los casos en los que la cabecera content-type tenga un problema, entonces el content-type de la respuesta será el formato por defecto de la API, actualmente application/json

Nota: Actualmente, la API no se adhiere al encabezado HTTP Accept-type, todas las respuestas se envían con el mismo tipo de contenido que la solicitud recibida, siempre que el tipo de contenido de la solicitud sea válido.

Autorización​

Esta cabecera es opcional y se utiliza para proporcionar detalles de autenticación a la API para el usuario actual, lo que le permitirá acceder a recursos restringidos de la API. Los tokens pueden obtenerse a través de la API de inicio de sesión. Un ejemplo de cabecera es:


Authorization: Bearer 45267dbe480c8c7d799c62ccad92cb44f67ab086

La cabecera Authorization acepta una cadena formada por dos partes separadas por un espacio. La primera parte es el tipo de token, la segunda es el propio token de acceso.

Errores de autorización​

Código de respuestaNotas
400Se ha proporcionado un encabezado de autorización malformado
401Falta el encabezado de autorización o el token no es válido o ha caducado.

Elegir un tipo de token de autorización​

En caso de fallo, las cabeceras de respuesta contendrán una cabecera WWW-Authenticate que indicará el tipo de token necesario para el acceso.