Saltar a contenido

Documentación v2

Introducción

Desk posee una API disponible para clientes donde es posible consultar y modificar múltiples entidades de nuestra plataforma.

Para poder hacer pruebas usted puede visitar nuestro sitio para pruebas de API, construido con el estándar Swagger, donde puede probar cada uno de los endpoints habilitados utilizando su Token de acceso.

Integraciones deben estar activadas en mi empresa

Si su empresa no cuenta con las integraciones activadas, usted no verá el link para obtener su Token de acceso. Esto se hace solicitando habilitar integraciones al área comercial de Desk.

Autentificación

Todas las peticiones hechas a nuestra API deben ser autentificadas. La API de Desk usa autenticación basada en token, lo que implica que para cada petición se debe incluir la Token de acceso en el header Authorization. En nuestro esquema, su token debe ser precedida por la palabra Key y un espacio.

Acá usted puede ver un ejemplo de como enviar la cabecera usando curl de manera correcta:

1
curl -H "Authorization: Key 30290ce5769e78f60e3b68a039d9276bb2d091663744572feef6f6e2bf190b68572d302f6469a10fc5dc6d755790812684a5881005310a"

Otro ejemplo usando la librería requests de Python:

1
2
3
4
import requests

headers = {'Authorization': 'Key 30290ce5769e78f60e3b68a039d9276bb2d091663744572feef6f6e2bf190b68572d302f6469a10fc5dc6d755790812684a5881005310a'}
r = requests.get(url, headers=headers)

Listado de servicios web