Для отримання даних про дзвінки, вам необхідно виконати GET-запит такого формату:
https://developers.ria.com/auto/new/calls_stat?user_id=Ваш_ID&from=ДАТА_ПОЧАТКУ_ВИБІРКИ&to=ДАТА_КІНЦЯ_ВИБІРКИ&api_key=YOUR_API_KEY
де user_id - Ваш ID в системі RIA.com; from та to - фільтр за діапазоном дат (рік - місяць - день); api_key - персональний ключ доступу користувача.
Приклад запиту
curl -X GET "https://developers.ria.com/auto/new/calls_stat?from=2022-06-01&to=2022-07-31&user_id=2121221&api_key=YOUR_API_KEY" -H "accept: application/json"
Відповідь
Дивись!
[
{
"call_id": 22346351,
"caller_phone": "0951174074",
"date": "2022-07-31T15:57:01",
"destination_phone": "0732245777",
"duration": 0,
"link": "",
"marka": "Acura",
"marka_id": 98,
"model": "MDX",
"model_id": 955,
"phone": "0730946407",
"price": 0,
"status": "CANCEL",
"waighting": 11
},
{
"call_id": 22345654,
"caller_phone": "0968404829",
"date": "2022-07-31T14:42:24",
"destination_phone": "0732245777",
"duration": 0,
"link": "",
"marka": null,
"marka_id": 0,
"model": null,
"model_id": 0,
"phone": "0508899747",
"price": 0,
"status": "BUSY",
"waighting": 48
},
{
"call_id": 22326708,
"caller_phone": "0674294559",
"date": "2022-07-30T17:00:12",
"destination_phone": "0732245777",
"duration": 57,
"link": "https://track.ria.com/call_link/56w456gw45v5765ee5ser_w45/2022/07/30/380732245777=380671111111=17-00-12.wav",
"marka": "Acura",
"marka_id": 98,
"model": "MDX",
"model_id": 955,
"phone": "0935063003",
"price": 0,
"status": "ANSWER",
"waighting": 22
},
{
"call_id": 22325473,
"caller_phone": "0933211888",
"date": "2022-07-30T15:30:21",
"destination_phone": "0732245777",
"duration": 0,
"link": "",
"marka": "Acura",
"marka_id": 98,
"model": "MDX",
"model_id": 955,
"phone": "0931122333",
"price": 0,
"status": "CANCEL",
"waighting": 44
}
]
Параметри:
Параметр |
Опис |
call_id |
Унільний ID дзвінка |
caller_phone |
Номер телефону, з якого був дзвінок |
date |
Дата і час дзвінка |
destination_phone |
Реальний номер на який переадресовувався дзвінок |
duration |
Тривалість дзвінка в секундах |
link |
Посилання на запис розмови |
marka |
Марка, якою цікавилися під час розмовиа |
marka_id |
ID марки |
model |
Модель, якою цікавилися під час розмови |
model_id |
ID моделі |
phone |
Підмінний номер телефону, на який дзвонили |
status |
Статус дзвінка (ANSWER, NOANSWER, CANCEL, BYSY, FAILED, CONGESTION) |
waighting |
Час у секундах, перш ніж відбулося з'єднання |
Другий спосіб передачі даних про дзвінок:
- У вас є back-end із веб-сервером.
- Ви передаєте свій url API (наприклад: https://your_site.com/api/call/call_from_auto_ria).
- Щойно клієнт ставить слухавку, на цю адресу ми відправляємо всі дані (список параметрів вище).
- Ви обробляєте отримані дані на своєму боці.