К содержанию
BSTCRMСправка

Первый запрос за 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;
}

Что дальше

Не нашли ответ?Напишите нам — ответим и допишем статью, чтобы следующему было понятнее.
Связаться с нами