보고 API는 무엇인가요?

Market Dojo는 Power BI와 같은 보고 도구에서 사용할 수 있도록 설계된 다양한 API 엔드포인트를 제공합니다.

아래에 나열된 엔드포인트 외에도 v1 API 엔드포인트 문서는 https://gl.marketdojo.com/api/v1/documentation 에서 확인할 수 있습니다.

보고 API 사용

요청은 다음 중 한 곳으로 해야 합니다.

- https://secure.marketdojo.com 또는

- 귀사에서 설정한 도메인(예: https://acme.marketdojo.com 또는 https://procurement.acme.com).

호스트 헤더에 다른 도메인이 포함된 요청은 차단됩니다.

보고 API는 두 가지 표준 매개변수를 사용합니다.

이메일 l: 엔드포인트에 접속하는 사용자의 이메일 주소

api_key : 사용자의 API 키 (이 키는 마켓도조 애플리케이션의 사용자 프로필 페이지에서 확인할 수 있습니다.)

명령줄에서 엔드포인트를 사용하는 경우 URL을 따옴표로 묶어야 할 수도 있습니다.

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

결과는 JSON 형식으로 반환됩니다.

확인해야 할 사항

• 사용자가 (기본) 그룹의 구성원인지 확인하십시오. 구성원이 아니면 403 오류가 발생합니다.

API 키 얻기

API를 사용하려면 API 키가 필요합니다.

API 키를 얻으려면 여기의 지침을 따르세요 .

API 키를 생성하거나 조회하는 옵션이 보이지 않으면 슈퍼호스트에 문의하여 관리자 > 통합 페이지에서 API를 활성화해 달라고 요청하십시오.

사용 가능한 보고 API 엔드포인트

회사들

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

이 엔드포인트는 사용자의 회사에 대한 정보를 반환합니다.

사용자

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

이 엔드포인트는 회사 내 모든 사용자에 대한 정보를 반환합니다.

계약

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

이 엔드포인트는 사용자가 볼 수 있는 계약에 대한 세부 정보를 반환합니다.

이벤트

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

이 엔드포인트는 사용자가 볼 수 있는 이벤트에 대한 세부 정보를 반환합니다.

설문지

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

이 엔드포인트는 설문 조사에 대한 세부 정보(응답 포함)를 반환합니다.

참고: `:id`는 설문지의 ID(숫자)로 바꿔야 합니다.

SIM 참가자

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

이 엔드포인트는 공급업체 온보딩 이벤트 참가자에 대한 세부 정보를 반환합니다.

SRM

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

이 엔드포인트는 사용자의 SRM 제품군에 대한 세부 정보를 반환합니다. 여기에는 srm_accounts, srm_contacts 활동 및 이벤트와 같은 정보가 포함됩니다.