API

Autorizacija

Svaki zahtev ka CRM API-ju prenosi zaglavlja za autorizaciju. Koja su zaglavlja potrebna za određenu metodu, navedeno je na njenoj stranici u odeljku „Autorizacija“.

Интеграције се ауторизују API токеном у заглављу Authorization. Приступни токен token-access се издаје при пријављивању преко API-ја и погодан је за апликације које раде у име корисника.

Заглавља

api-token

Заглавље: Authorization · Формат: fs_api_* · Koristi se u metodama: 47

API токен из секције api_tokens. Вредност заглавља Authorization је Bearer <токен>. Токен партнера: ако је при издавању токена изабран ланац, ради само са тим ланцем и заглавље chain није потребно. Ако ланац није изабран, токен има приступ свим ланцима налога, али нема активан ланац. Сваки захтев који захтева ланац мора да проследи заглавље chain, у супротном се враћа грешка 117 са field: chain. /chains враћа ланце налога; /chains.switch није доступан за токен (грешка 268).

Пример

Authorization: Bearer fs_api_YOUR_TOKEN

language

Заглавље: language · Koristi se u metodama: 56

Језик одговора — ISO 639-1 код, на пример ru

Пример

language: sr

role

Заглавље: role · Koristi se u metodama: 56

Uloga korisnika: partner ili affiliate

Пример

role: affiliate

chain

Заглавље: chain · Koristi se u metodama: 0

Мрежа у којој се извршава захтев. Обавезно само за партнерски токен издат без избора мреже; у осталим случајевима се игнорише

Пример

chain: YOUR_TOKEN

Скуп заглавља

Metod prihvata jedan od skupova. Skupovi sa API tokenom pogodni su za integracije.

api-token + language + roleметода: 47
language + roleметода: 9

Грешке приступа

Nevažeći, blokirani ili istekli token, kao i zahtev bez potrebnog zaglavlja, vraćaju grešku sa kodom. Vrednosti kodova nalaze se u odeljku „Грешке“.

Грешке →