Početak rada

CRM API FoodSoul za afilijate: povezane kompanije, izveštaji, kontragent i isplate — iz sopstvenog sistema, bez prijavljivanja u CRM.

Šta je CRM API

CRM API — HTTP API са одговорима у JSON формату. Преко њега спољни систем ради са истим подацима као и CRM FoodSoul: чита их, креира и мења у име налога.

Svi zahtevi se šalju putem HTTPS-a na adresu https://foodsoul.ru/api/crm/v2.

API vodič opisuje svaku metodu: parametre, telo zahteva, odgovore i primere na curl, PHP, JavaScript i Python. Kompletan opis API-ja možete preuzeti u OpenAPI formatu i povezati ga u Postman, Insomnia ili SDK generator.

Kako dobiti API token

Zahtevi za integraciju se autorizuju putem API tokena. Token izdaje vlasnik ili administrator naloga u CRM-u, u odeljku „API tokeni“.

Отворите у CRM одељак „API токени“ и креирајте токен.
Izaberite ulogu tokena: od nje zavise dostupne metode. Uloga izdatog tokena ne može se promeniti.
Po potrebi odredite rok važenja tokena i dozvoljene IP adrese.
Kopirajte token odmah nakon kreiranja: otvorena vrednost se prikazuje samo jednom i ne može se povratiti.

Токен почиње са fs_api_ и преноси се у заглављу Authorization: Bearer <токен>. Токен се чува као лозинка: не објављујте га у коду сајтова и мобилних апликација и не прослеђујте трећим лицима. Изгубљени токен блокирајте или обришите у истом одељку CRM-а.

Prvi zahtev

Проверите токен захтевом „Dobijanje podataka o korisniku“. Уместо fs_api_YOUR_TOKEN унесите свој токен.

Поред токена, сваки захтев шаље и заглавља role — улога, за овај API affiliate, и language — језик текстова у одговору, на пример sr.

curl -X GET 'https://foodsoul.ru/api/crm/v2/application.user_info' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: sr' \
  -H 'role: affiliate'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://foodsoul.ru/api/crm/v2/application.user_info', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'sr',
        'role' => 'affiliate',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.ru/api/crm/v2/application.user_info", {
    method: "GET",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "sr",
        "role": "affiliate"
    },
})
const data = await response.json()

import requests

response = requests.request(
    "GET",
    "https://foodsoul.ru/api/crm/v2/application.user_info",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "sr",
        "role": "affiliate",
    },
)
data = response.json()

Uspešan odgovor — HTTP 200 i JSON sa status: success, podaci se nalaze u polju data. U slučaju greške status je error, a kod i opis greške su u polju error.

Опис метода: Dobijanje podataka o korisniku →

Šta dalje

Референца API — све методе са параметрима, одговорима и примерима захтева
Autorizacija — наслови ауторизације и скупови који прихватају методе
Вебхуки — обавештења о догађајима на адресу вашег система
Грешке — кодови грешака и њихова значења
Izmene — шта се променило у API
Преузми OpenAPI · YAML