A Market Dojo API

A Market Dojo API

Mi a problémád?

Szeretnék csatlakozni a Market Dojo API-hoz. Hogyan tehetem ezt meg?

Megoldás

A Market Dojo programozottan érhető el az API használatával.

Lépések

  1. Bejelentkezés a Market Dojóba

  2. Menj a profilodra, jegyezd fel az e-mail címedet és a Market Dojo API kulcsodat.

  3. Látogasson el a https://secure.marketdojo.com/api/v1/documentation oldalra.  

  4. Tekintse át az elérhető végpontokat az API működésének megértéséhez

  5. Ne feledd, hogy közvetlenül a dokumentációs oldalról is kísérletezhetsz az API-val.

Mik azok a jelentéskészítő API-k?

A Market Dojo számos API-végpontot biztosít, amelyeket olyan jelentéskészítő eszközökkel való használatra terveztek, mint a Power BI.

Az alább felsorolt végpontokon kívül a v1 API végpont dokumentációja a https://gl.marketdojo.com/api/v1/documentation címen található.

A jelentéskészítő API-k használata

A kérelmeket a következő címekre kell benyújtani:

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

- a vállalat konfigurált domainje (pl. https://acme.marketdojo.com vagy https://procurement.acme.com).


A bármely más domainhez tartozó host headerrel rendelkező kérések blokkolva vannak.


A jelentéskészítő API-k 2 szabványos paramétert fogadnak el:

emai l: a végpontot elérő felhasználó e-mail címe

api_key : a felhasználó API-kulcsa (ez megtalálható a profiloldalukon a Market Dojo alkalmazásban)


Ha a parancssorból használod a végpontokat, szükség lehet idézőjelek közé tenni az URL-t.


például

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


Az eredményeket JSON formátumban adjuk vissza.

Ellenőrizendő dolgok

  • A felhasználó tagja-e az (alapértelmezett) csoportnak? Ha nem, 403-as hibát kap.

API-kulcs beszerzése

Az API használatához API kulcs szükséges.

Az API-kulcs megszerzéséhez kövesd az itt található utasításokat .

Ha nem látod az API-kulcs létrehozásának vagy megtekintésének lehetőségét, kérd meg a szuperhosztodat, hogy engedélyezze az API-t az Adminisztráció>Integrációk oldalon.


Elérhető jelentéskészítő API-végpontok

Cégek

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


Ez a végpont a felhasználó vállalatával kapcsolatos információkat fog visszaadni.

Felhasználók

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


Ez a végpont a vállalat összes felhasználójáról ad vissza információkat.

Szerződések

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



Ez a végpont visszaadja azoknak a szerződéseknek a részleteit, amelyek megtekintéséhez a felhasználó hozzáféréssel rendelkezik.

Események

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


Ez a végpont azoknak az eseményeknek a részleteit adja vissza, amelyek megtekintéséhez a felhasználó hozzáféréssel rendelkezik.

Kérdőív

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


Ez a végpont egy kérdőív részleteit adja vissza, beleértve a kapott válaszokat is.

MEGJEGYZÉS: Az :id helyére a kérdőív azonosítóját (egy számot) kell írni.

SIM-résztvevők

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


Ez a végpont a beszállítói bevezetési esemény résztvevőinek adatait adja vissza.


SRM

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


Ez a végpont a felhasználó SRM csomagjának részleteit adja vissza. Ilyen információk például az srm_accounts, az srm_contacts tevékenységek és események.