Početak rada

Š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“.

1. Отворите у CRM одељак „API токени“ и креирајте токен.
2. Izaberite ulogu tokena: od nje zavise dostupne metode. Uloga izdatog tokena ne može se promeniti.
3. Да би токен радио само са једном мрежом, изаберите је. Без избора мреже, токену су доступне све мреже налога, а захтеви преносе мрежу у заглављу chain.
4. Po potrebi odredite rok važenja tokena i dozvoljene IP adrese.
5. 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 partner, и 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: partner'

<?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' => 'partner',
    ],
]);

$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": "partner"
    },
})
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": "partner",
    },
)
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