Отримання даних про дзвінок¶
GET API для отримання даних про дзвінок¶
Щоб отримати дані про дзвінки, вам необхідно виконати GET-запит такого формату:
https://developers.ria.com/auto/new/calls_stat?user_id=Ваш_ID&from=ДАТА_ПОЧАТКУ_ВИБІРКИ&to=ДАТА_КІНЦЯ_ВИБІРКИ&api_key=YOUR_API_KEY
або
curl -X GET "https://developers.ria.com/auto/new/calls_stat?user_id=Ваш_ID&from=ДАТА_ПОЧАТКУ_ВИБІРКИ&to=ДАТА_КІНЦЯ_ВИБІРКИ&api_key=YOUR_API_KEY" -H "accept: application/json"
де user_id - Ваш ID в системі RIA.com; from, to - фільтр за діапазоном дат (рік - місяць - день); api_key - Ваш ключ.
Приклад запиту
curl -X GET "https://developers.ria.com/auto/new/calls_stat?from=2021-06-01&to=2021-07-31&user_id=1505029&api_key=YOUR_API_KEY" -H "accept: application/json"
Приклад успішної відповіді: [1]:
[
{
"call_id": 22346351,
"caller_phone": "0951174074",
"date": "2021-07-31T15:57:01",
"destination_phone": "0731375686",
"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": "2021-07-31T14:42:24",
"destination_phone": "0731375686",
"duration": 0,
"link": "",
"marka": null,
"marka_id": 0,
"model": null,
"model_id": 0,
"phone": "0504103684",
"price": 0,
"status": "BUSY",
"waighting": 48
},
{
"call_id": 22326708,
"caller_phone": "0674294559",
"date": "2021-07-30T17:00:12",
"destination_phone": "0731375686",
"duration": 57,
"link": "https://track.ria.com/call_link/56w456gw45v5765ee5ser_w45/2021/07/30/380731375686=380674294559=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": "0931426064",
"date": "2021-07-30T15:30:21",
"destination_phone": "0731375686",
"duration": 0,
"link": "",
"marka": "Acura",
"marka_id": 98,
"model": "MDX",
"model_id": 955,
"phone": "0936073263",
"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 - Час у секундах, перш ніж відбулося з“єднання
POST API для отримання даних про дзвінок¶
Другий спосіб передачі даних про дзвінок:
- У вас є back-end із веб-сервером.
- Ви передаєте свій url API (наприклад: https://your_site.com/api/call/call_from_auto_ria).
- Щойно клієнт ставить слухавку, на цю адресу ми відправляємо всі дані (список параметрів в [п.1][1]).
- Ви обробляєте отримані дані на своєму боці.