Первый запрос за 5 минут
Проверяем ключ: получаем список сделок командой curl, на Python и на PHP.
Здесь — самый короткий путь от ключа до первых данных. Вместо https://ваша-компания.bstcrm.ru подставьте адрес своей CRM, вместо bst_… — свой ключ.
Шаг 1. Получите справочники
Запрос возвращает точки, воронки, статусы сделок, сотрудников и кассы — их номера (id) понадобятся в других запросах.
bash
curl https://ваша-компания.bstcrm.ru/meta/reference \
-H "Authorization: Bearer bst_ваш_ключ"Ответ (сокращённо):
json
{
"branches": [{"id": 1, "code": "acorus", "name": "Акорус"}],
"pipelines": [{"id": 1, "branch_id": 1, "name": "Автосервис"}],
"statuses": [{"id": 1, "pipeline_id": 1, "code": "new", "name": "Неразобранное", "is_success": false}],
"users": [{"id": 2, "branch_id": 1, "name": "Светлана Орлова", "role": "manager"}],
"money_accounts": [{"id": 1, "branch_id": 1, "name": "Касса Акорус", "type": "cash"}]
}Шаг 2. Последние сделки
bash
curl "https://ваша-компания.bstcrm.ru/api/orders?limit=5" \
-H "Authorization: Bearer bst_ваш_ключ"То же на Python
python
import requests
BASE = "https://ваша-компания.bstcrm.ru"
HEADERS = {"Authorization": "Bearer bst_ваш_ключ"}
deals = requests.get(f"{BASE}/api/orders", params={"limit": 5}, headers=HEADERS, timeout=15).json()
for deal in deals["items"]:
print(deal["id"], deal["client"], deal["status"], deal["total_amount"])То же на PHP
php
<?php
$ch = curl_init("https://ваша-компания.bstcrm.ru/api/orders?limit=5");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer bst_ваш_ключ"],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
]);
$deals = json_decode(curl_exec($ch), true);
foreach ($deals["items"] as $deal) {
echo $deal["id"] . " " . $deal["client"] . " " . $deal["total_amount"] . PHP_EOL;
}