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_TOKENlanguage
Заглавље: language · Koristi se u metodama: 56
Језик одговора — ISO 639-1 код, на пример ru
Пример
language: srrole
Заглавље: role · Koristi se u metodama: 56
Uloga korisnika: partner ili affiliate
Пример
role: affiliatechain
Заглавље: 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 „Грешке“.
Грешке →