Encabezados HTTP

Esta sección describe los encabezados HTTP que la API aceptará de cualquier solicitud.

Content-Type

Todas las solicitudes deben contener un encabezado HTTP Content-Type.

Tipos de contenido aceptados

Formato base	Tipos de contenido	Tipos de contenido
JSON	application/json	text/json no es actualmente un tipo de contenido aceptado
Datos de formulario	multipart/form-data	Solo se usa al subir variaciones

Errores de Content-Type

Código de respuesta	Notas
400	Se entendió el tipo de contenido, pero no se pudo decodificar. Aparecerá más información en el cuerpo de la respuesta
415	El tipo de contenido falta o no es compatible

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

Nota: Actualmente, la API no se ajusta al encabezado HTTP Accept-type; todas las respuestas se envían en el mismo content-type que la solicitud recibida, siempre que el content-type de la solicitud fuera válido

Autorización

Este encabezado es opcional y se usa para proporcionar detalles de autenticación a la API para el usuario actual, lo que permitirá al usuario actual acceder a recursos restringidos de la API. Los tokens se pueden obtener a través de la API de inicio de sesión. Un ejemplo de encabezado es:

Authorization: Bearer 45267dbe480c8c7d799c62ccad92cb44f67ab086

El encabezado Authorization acepta una cadena que se construye a partir de dos partes, separadas por un solo espacio. La primera parte es el tipo de token, la segunda es el token de acceso en sí.

Errores de autorización

Código de respuesta	Notas
400	Se proporcionó un encabezado de autorización mal formado
401	El encabezado de autorización falta o el token no era válido o ha expirado

Elegir un tipo de token de autorización

En cualquier fallo, los encabezados de respuesta contendrán un encabezado WWW-Authenticate que indicará el tipo de token requerido para el acceso.