La API de Market Dojo

La API de Market Dojo

¿Cuál es el problema al que te enfrentas?

Me gustaría conectarme a la API de Market Dojo. ¿Cómo puedo hacerlo?

Solución

Se puede acceder a Market Dojo mediante programación utilizando la API.

Pasos

  1. Inicia sesión en Market Dojo.

  2. Ve a tu página de perfil, anota tu correo electrónico y tu clave API de Market Dojo.

  3. Visita https://secure.marketdojo.com/api/v1/documentation  

  4. Revise los puntos de acceso disponibles para comprender cómo funciona la API.

  5. Tenga en cuenta que puede experimentar con la API directamente desde la página de documentación.

¿Cuáles son las API de informes?

Market Dojo proporciona varios puntos de acceso API diseñados para su uso con herramientas de generación de informes como Power BI.

Además de los puntos finales que se enumeran a continuación, la documentación de los puntos finales de la API v1 se puede encontrar en https://gl.marketdojo.com/api/v1/documentation

Uso de las API de informes

Las solicitudes deben dirigirse a:

- https://secure.marketdojo.com, o

- El dominio configurado de su empresa (por ejemplo, https://acme.marketdojo.com o https://procurement.acme.com).


Las solicitudes que incluyan una cabecera de host para cualquier otro dominio serán bloqueadas.


Las API de informes aceptan 2 parámetros estándar:

correo electrónico: el correo electrónico del usuario que accede al punto final.

api_key : la clave API del usuario (esta se puede encontrar en su página de perfil en la aplicación Market Dojo).


Si se utilizan los puntos finales desde la línea de comandos, puede ser necesario encerrar la URL entre comillas.


p.ej

curl ' https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=api_key '


Los resultados se devuelven en formato JSON.

Cosas que revisar

  • ¿El usuario pertenece al grupo (predeterminado)? Si no, recibirá un error 403.

Obtención de una clave API

Se requiere una clave API para utilizar la API.

Siga las instrucciones aquí para obtener su clave API.

Si no ve la opción para crear o ver su clave API, solicite a su proveedor de alojamiento web que habilite la API en la página Admin > Integraciones.


Puntos finales de la API de informes disponibles

Empresas

https://secure.marketdojo.com/api/v2/reports/companies?email=email&api_key=key


Este punto final devolverá información sobre la empresa del usuario.

Usuarios

https://secure.marketdojo.com/api/v2/reports/users?email=email&api_key=key


Este punto final devolverá información sobre todos los usuarios de la empresa.

Contratos

https://secure.marketdojo.com/api/v2/reports/contracts?email=email&api_key=key



Este punto final devolverá los detalles de los contratos que el usuario tiene acceso para visualizar.

Eventos

https://secure.marketdojo.com/api/v2/reports/events?email=email&api_key=key


Este punto final devolverá los detalles de los eventos que el usuario tiene acceso para visualizar.

Cuestionario

https://secure.marketdojo.com/api/v2/reports/questionnaires/:id?email=email&api_key=key


Este punto final devolverá los detalles de un cuestionario, incluidas las respuestas que ha recibido.

NOTA: :id debe reemplazarse con el ID (un número) del cuestionario.

Participantes de la simulación

https://secure.marketdojo.com/api/v2/reports/sim_participants?email=email&api_key=key


Este punto final devolverá los detalles de los participantes en un evento de incorporación de proveedores.


SRM

https://secure.marketdojo.com/api/v2/reports/srm?email=email&api_key=key


Este punto final devolverá detalles de la suite SRM de un usuario. Información como cuentas srm_accounts, actividades srm_contacts y eventos.