API do Market Dojo

API do Market Dojo

Qual é o problema que você está enfrentando?

Gostaria de me conectar à API do Market Dojo. Como posso fazer isso?

Solução

O Market Dojo pode ser acessado programaticamente usando a API.

Passos

  1. Faça login no Market Dojo

  2. Acesse a página do seu perfil e anote seu e-mail e a chave da API do Market Dojo.

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

  4. Analise os endpoints disponíveis para entender como a API funciona.

  5. Observe que você pode experimentar a API diretamente da página de documentação.

Quais são as APIs de relatório?

O Market Dojo fornece uma série de endpoints de API projetados para uso com ferramentas de geração de relatórios, como o Power BI.

Além dos endpoints listados abaixo, a documentação dos endpoints da API v1 pode ser encontrada em https://gl.marketdojo.com/api/v1/documentation

Utilizando as APIs de relatório

Os pedidos devem ser feitos para:

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

- o domínio configurado da sua empresa (por exemplo, https://acme.marketdojo.com ou https://procurement.acme.com).


Solicitações com um cabeçalho de host para qualquer outro domínio serão bloqueadas.


As APIs de relatório utilizam 2 parâmetros padrão:

e-mail : o e-mail do usuário que está acessando o endpoint

api_key : a chave de API do usuário (pode ser encontrada na página de perfil dele no aplicativo Market Dojo)


Ao utilizar os endpoints a partir da linha de comando, pode ser necessário colocar a URL entre aspas.


por exemplo

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


Os resultados são retornados em formato JSON.

Coisas a verificar

  • O usuário é membro do grupo (padrão)? Caso contrário, receberá um erro 403.

Como obter uma chave de API

É necessária uma chave de API para usar a API.

Siga as instruções aqui para obter sua chave de API.

Caso não veja a opção para criar ou visualizar sua chave de API, solicite ao seu superhost que habilite a API na página Admin > Integrações.


Endpoints de API de relatório disponíveis

Empresas

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


Este endpoint retornará informações sobre a empresa do usuário.

Usuários

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


Este endpoint retornará informações sobre todos os usuários da empresa.

Contratos

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



Este endpoint retornará detalhes dos contratos que o usuário tem acesso para visualizar.

Eventos

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


Este endpoint retornará detalhes dos eventos que o usuário tem acesso para visualizar.

Questionário

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


Este endpoint retornará detalhes de um questionário, incluindo as respostas recebidas.

NOTA: :id deve ser substituído pelo id (um número) do questionário.

Participantes do SIM

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


Este endpoint retornará detalhes dos participantes em um evento de integração de fornecedores.


SRM

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


Este endpoint retornará detalhes do conjunto de ferramentas SRM de um usuário. Informações como srm_accounts, srm_contacts, atividades e eventos.




    • Related Articles

    • Como criar uma conta no Market Dojo

      Qual é o problema que você está enfrentando? Gostaria de criar uma conta no Market Dojo. Como posso fazer isso? Solução Para se cadastrar em uma conta Market Dojo: Acesse este link: https://secure.marketdojo.com/signup , insira seu endereço de e-mail ...

    • Como devo lidar com usuários que deixaram a empresa ou que não precisam mais de acesso ao Market Dojo?

      Qual é o problema que você está enfrentando? Tenho um usuário que deixou a empresa. Como faço para desativar usuários no Market Dojo? Solução Se um usuário deixou a empresa e você precisa desativá-lo, siga estes passos: Faça login no seu portal ...

    • Como posso habilitar a integração com o Per Angusta?

      Qual é o problema que você está enfrentando? Gostaria de habilitar a integração entre o Spend HQ (Per Angusta) e o Market Dojo. Como posso fazer isso? Solução Se você utiliza tanto o Market Dojo quanto o Per Angusta, pode habilitar a integração entre ...

    • Como configurar a integração com o Spend HQ (por Angusta)

      Se você utiliza tanto o Market Dojo quanto o Spend HQ, pode habilitar a integração entre os dois sistemas. O que isso lhe permite fazer - Mudar de uma para a outra sem precisar fazer login novamente - Crie eventos do Market Dojo diretamente do Spend ...

    • Como configurar a integração SSO com o Okta

      Qual é o problema que você está enfrentando? Gostaria de configurar a integração entre o Market Dojo e o Okta. Como faço isso? Solução O que a Okta faz? A Okta permite que as organizações administrem a segurança de forma centralizada. Aqui está um ...