Метод
GET https://panel.bizzup.ru/api/company_contacts.list
Параметры запроса
| Поле | Тип | Где | Обязательный | Назначение | Возможные значения |
|---|
project |
string |
query |
да |
Код проекта-клиента API |
project-panel, talkiq и др. |
api_key |
string |
query |
да |
API-ключ для авторизации |
Строка из PROJECT_BASE_API_KEYS |
company_id |
integer |
query |
нет |
Фильтр по ID компании Bitrix24 |
Положительное целое, ID компании в Bitrix24 |
Поля ответа (верхний уровень)
| Поле | Тип | Назначение | Возможные значения |
|---|
count |
integer |
Количество найденных контактов |
0, 1, 2, ... |
data |
array |
Массив объектов контактов |
[] или [{...}, {...}] |
Поля объекта контакта (data[].*)
| Поле | Тип | Назначение | Возможные значения |
|---|
id |
integer |
ID записи в БД |
1, 2, 3, ... |
bitrix_id |
integer |
ID контакта в Bitrix24 |
Положительное целое |
phone |
string | null |
Номер телефона контакта |
+79990000000, null |
company_ids |
string | null |
Связанные ID компаний в Bitrix24 |
10,11, 11, null |
name |
string | null |
Имя контакта |
Иван Иванов, null |
assigned_by_id |
integer | null |
ID ответственного сотрудника в Bitrix24 |
77, null |
trouble_contact |
string | null |
Признак проблемного контакта |
true, null |
perplexity_reason |
string | null |
Причина/комментарий по проблемности |
Пустое имя, null |
Коды ответа HTTP
| Код | Назначение |
|---|
| 200 OK | Успешный ответ |
| 400 Bad Request | Невалидный company_id |
| 401 Unauthorized | Неверные project или api_key |
| 405 Method Not Allowed | Неверный HTTP-метод |
| 429 Too Many Requests | Превышен rate limit (5 req/sec, burst 250) |
| 500 Internal Server Error | Ошибка чтения данных из БД |
Пример (Python)
import requests
url = 'https://panel.bizzup.ru/api/company_contacts.list'
params = {
'project': 'your_project_code',
'api_key': 'YOUR_API_KEY',
'company_id': 11, # optional
}
response = requests.get(url, params=params, timeout=15)
response.raise_for_status()
payload = response.json()
print('count:', payload['count'])
for row in payload['data'][:3]:
print(row['bitrix_id'], row['name'])
← К списку методов