Статус повідомлення Viber 2 Way

Приклад запиту для отримання статусу повідомлення Viber 2 Way. Сервіс Viber 2 Way призначений для отримання зворотного зв'язку на повідомлення від споживача.

URI: /api/json.php

Усі запити до API надсилаються у форматі JSON за допомогою методу POST.

Параметри заголовків

У запитах обов'язково має бути заголовок Content-Type: application/json, інакше запит буде вважатися некоректним навіть при валідному JSON у ньому.

Параметри запиту

authstringобов'язковий Ваш API-ключ, який можна отримати в особистому кабінеті

datalist[object]обов'язковий Список об'єктів з параметрами запиту typestringобов'язковий Тип запиту idnumberобов'язковий Унікальний ідентифікатор повідомлення в системі клієнта

Приклад запиту

{
    "auth": "bb56a4369eb19***cfec6d1776bd25",
    "data": [
        {
            "type": "status",
            "id": 100500
        }
    ]
}

Параметри відповіді

successinteger Результат виконання запиту

errorstring Текст помилки, що повертається, якщо success=false

datalist[object] Список об'єктів з результатами виконання запиту successboolean Результат виконання запиту повернутий у пакеті даних dataobject Результат виконання запиту idnumber Унікальний ідентифікатор повідомлення в системі клієнта typestring Тип повідомлення: sms, viber, rcs statusstring Поточний статус повідомлення (див. Довідник статусів повідомлень) replieslist[object] Список відповідей на повідомлення datetimestring Дата і час отримання відповіді Формат: YYYYY-MM-DDThh:mm:ss±hh:mm messagestring Текст повідомлення mediaobject Об'єкт, що містить інформацію про медіафайл, прикріплений до повідомлення urlstring Посилання на медіафайл filenamestring Ім'я медіафайлу filesizenumber Розмір медіафайлу

Приклади відповіді

Успішний

HTTP Status Code: 200
Content Type: JSON application/json

{
    "success": true,
    "data": [
        {
            "success": true,
            "data": {
                "id":10500,
                "type": "viber",
                "status": "REPLIED",
                "replies": [
                    {
                        "datetime": "2022-05-01T12:01:02+03:00",
                        "message": "Please wait"
                    },
                    {
                        "datetime": "2022-05-03T14:21:17+03:00",
                        "media": {
                            "url": "https://url.com/home/vibermedia/",
                            "filename": "invoice.pdf",
                            "filesize": 67983
                        }
                    },
                    {
                        "datetime": "2022-05-03T14:21:17+03:00",
                        "message": "Correct invoice",
                        "media": {
                            "url": "https://url.com/home/vibermedia/",
                            "filename": "invoice.pdf",
                            "filesize": 68934
                        }
                    }
                ]
            }
        }
    ]
}

Доступ заборонено

HTTP Status Code: 200
Content Type: JSON application/json

{
    "success": false,
    "error": "Access denied"
}