Dicho Token está asociado a un user de Sytex y los permisos de ese usuario son los que determinan el nivel de acceso a los distintos endpoints. Por ejemplo, si el usuario sólo tiene acceso a las tareas de un proyecto A, una llamada al endpoint de tareas va a filtrar los resultados de manera que sólo tareas del proyecto A sean retornadas.
Métodos soportados
POST: crear un recurso nuevo.
PUT: modificar un recurso existente.
GET: consultar información de un recurso.
DELETE: eliminar un recurso determinado.
PATCH: modificar solamente un atributo de un recurso.
Requests & responses
Tanto los requests como los responses están en formato JSON. Los requests deberán incluir las cabeceras
Accept: application/json
Content-Type: application/json
para los requests tipo POST, PUT o PATCH.
Respuestas y códigos de error
Las API de Sytex utilizan códigos HTTP estándar para informar estados de resolución de los requests.
200
OK. Ejecución satisfactoria, el cuerpo de la respuesta contendrá el contenido requerido.
400
Error de validación. El contenido de la respuesta contendrá un detalle por cada campo con el error de validación. Si el error no está referido a un campo en particular, estará presente en el atributo "non_field_errors" del objeto JSON de la respuesta. Cada atributo del cuerpo de la respuesta corresponde con el campo que generó el error de validación, cada campo tendrá una lista de errores asociados.
401
Sin autenticación. No se envió información de autenticación en la cabecera o el token se encuentra vencido.
403
Prohibido. El usuario vinculado al request no tiene permisos suficientes para realizarlo.
404
No encontrado. La URL requerida no existe en el esquema de la aplicación o el id del objeto requerido no existe.
500
Error en la aplicación.
Organización
Todos los requests deben contener un header con el número de Organización.El formato es simplemente un header llamado “Organization” y su valor es un número entero. Consultar cuál es el número. Ejemplo: Organization: 658