První volání

S přístupovým tokenem můžete zavolat první endpoint. Dobrým začátkem je informace o firmě — ověříte si, že autentizace funguje, a rovnou získáte hodnoty číselníků.

GEThttps://app.mwork365.com/main/publicapi/company

curl -L -X GET 'https://app.mwork365.com/main/publicapi/company' \
-H 'Authorization: Bearer eyJhb...WlUw'

Odpověď

200 OK

Informace o firmě včetně číselníků a jejich hodnot — CompanyDetail

400, 401, atd.

Více informací o standardních chybových stavech

Proč začít právě tímto voláním

Odpověď obsahuje všechny číselníky firmy — kategorie zákazníků, typy zařízení, kategorie zakázek, vlastní stavy, dodavatele materiálu, sklady a další. Na tyto hodnoty se odkazuje většina zápisových endpointů: když například zakládáte zakázku, její categoryId musí být ID nebo slug některé z kategorií vrácených zde.

Tip

Číselníky se mění zřídka. Načtěte je při startu integrace a držte si je v paměti — nemusíte je tahat před každým voláním.

Kam dál

• Datový model — jaké typy API vrací a jak na sebe navazují.
• ID, externí ID a slug — jak se na záznamy odkazovat identifikátory z vašeho systému.
• Chybové stavy — co které návratové kódy znamenají.