API Market Dojo

API Market Dojo

Bạn đang gặp phải vấn đề gì?

Tôi muốn kết nối với API của Market Dojo. Tôi có thể làm điều này như thế nào?

Giải pháp

Bạn có thể truy cập Market Dojo bằng lập trình thông qua API.

Các bước

  1. Đăng nhập vào Market Dojo

  2. Hãy vào trang hồ sơ của bạn, ghi lại địa chỉ email và mã API của Market Dojo.

  3. Truy cập https://secure.marketdojo.com/api/v1/documentation  

  4. Hãy xem xét các điểm cuối API khả dụng để hiểu cách API hoạt động.

  5. Lưu ý rằng bạn có thể thử nghiệm API trực tiếp từ trang tài liệu.

Các API báo cáo là gì?

Market Dojo cung cấp một số điểm cuối API được thiết kế để sử dụng với các công cụ báo cáo như Power BI.

Ngoài các điểm cuối được liệt kê bên dưới, tài liệu về điểm cuối API v1 có thể được tìm thấy tại https://gl.marketdojo.com/api/v1/documentation

Sử dụng API báo cáo

Yêu cầu phải được gửi đến một trong hai địa chỉ sau:

- https://secure.marketdojo.com, hoặc

- Tên miền đã được cấu hình của công ty bạn (ví dụ: https://acme.marketdojo.com hoặc https://procurement.acme.com).


Các yêu cầu có tiêu đề máy chủ thuộc bất kỳ tên miền nào khác đều bị chặn.


Các API báo cáo nhận 2 tham số tiêu chuẩn:

email : địa chỉ email của người dùng truy cập vào điểm cuối.

api_key : mã API của người dùng (có thể tìm thấy trên trang hồ sơ của họ trong ứng dụng Market Dojo)


Nếu sử dụng các điểm cuối từ dòng lệnh, có thể cần phải đặt URL trong dấu ngoặc kép.


ví dụ

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


Kết quả được trả về ở định dạng JSON.

Những điều cần kiểm tra

  • Người dùng có phải là thành viên của nhóm (mặc định) không? Nếu không, họ sẽ nhận được lỗi 403.

Lấy khóa API

Để sử dụng API, bạn cần có Khóa API.

Hãy làm theo hướng dẫn tại đây để lấy Khóa API của bạn.

Nếu bạn không thấy tùy chọn tạo hoặc xem Khóa API, vui lòng yêu cầu nhà cung cấp dịch vụ lưu trữ (superhost) của bạn kích hoạt API trên trang Quản trị > Tích hợp.


Các điểm cuối API báo cáo khả dụng

Các công ty

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


Điểm cuối này sẽ trả về thông tin về công ty của người dùng.

Người dùng

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


Điểm cuối này sẽ trả về thông tin về tất cả người dùng trong công ty.

Hợp đồng

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



Điểm cuối này sẽ trả về thông tin chi tiết về các hợp đồng mà người dùng có quyền xem.

Sự kiện

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


Điểm cuối này sẽ trả về thông tin chi tiết về các sự kiện mà người dùng có quyền xem.

Bảng câu hỏi

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


Điểm cuối này sẽ trả về thông tin chi tiết của bảng câu hỏi, bao gồm cả các câu trả lời đã nhận được.

LƯU Ý: :id cần được thay thế bằng mã số (ID) của bảng câu hỏi.

Người tham gia SIM

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


Điểm cuối này sẽ trả về thông tin chi tiết của những người tham gia vào sự kiện gia nhập nhà cung cấp.


SRM

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


Điểm cuối này sẽ trả về thông tin chi tiết về bộ SRM của người dùng. Thông tin như srm_accounts, srm_contacts, các hoạt động và sự kiện.