Список тикетов веб-мастера

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET tickets https://api.admitad.com/tickets/
  • offset**
  • limit**
  • date_start*
  • date_end*
  • status****
Возвращает список тикетов веб-мастера.***
GET tickets https://api.admitad.com/tickets/{id}/ Возвращает тикет, где id - это идентификатор тикета.*
  • **** Фильтр по статусу тикета. Например: status=2.
  • *** Фильтр по дате создания тикета. Например: date_start=02.08.2013&date_end=04.08.2013.
  • ** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.
  • * Возвращает результат в формате JSON.

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/tickets/?status=1&limit=1

Пример ответа API-сервера в формате JSON:

{
    "results": [
        {
            "category": {
                "id": 1,
                "name": "Общие вопросы"
            },
            "status": 1,
            "date_modified": "2014-09-12T12:56:39",
            "text": "<br/>Текст вашего сообщения.",
            "plain_text": "Текст вашего сообщения.",
            "advcampaign": {},
            "priority": 2,
            "date_created": "2014-09-12T12:56:39",
            "id": 50,
            "subject": "Тема сообщения."
        }
    ],
    "_meta": {
        "count": 4,
        "limit": 1,
        "offset": 0
    }
}

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/tickets/3/

Пример ответа API-сервера в формате JSON:

{
    "status": 1,
    "category": {
        "name": "Общие вопросы",
        "id": 1
    },
    "date_modified": "2014-09-12T13:15:39",
    "text": "<br/>Текст вашего сообщения.",
    "plain_text": "Текст вашего сообщения.",
    "messages": [
        {
            "files": [],
            "text": "<p>Ответ менеджера.</p>",
            "plain_text": "Ответ менеджера.",
            "id": 38,
            "created_by": {
                "id": 124,
                "first_name": "Алефтина",
                "last_name": "Иванова"
            },
            "date_created": "2014-09-12T13:16:55"
        },
        {
            "files": [],
            "text": "Ваш комментарий.",
            "plain_text": "Ваш комментарий.",
            "id": 39,
            "created_by": {
                "id": 125,
                "first_name": "Степан",
                "last_name": "Гольдман"
            },
            "date_created": "2014-09-12T13:16:44"
        },
        {
            "files": [
                {
                    "id": 1,
                    "attach_full_path": "http://admitad.com/public/tickets/files/50/comments/circum.jpeg"
                }
            ],
            "text": "<p>Ответ менеджера.</p>",
            "plain_text": "Ответ менеджера.",
            "id": 40,
            "created_by": {
                "id": 124,
                "first_name": "Алефтина",
                "last_name": "Иванова"
            },
            "date_created": "2014-09-12T13:16:32"
        }
    ],
    "priority": 2,
    "date_created": "2014-09-12T12:56:39",
    "id": 50,
    "subject": "Ваша тема."
}

Описание полей ответа API-сервера

Название Описание
id Идентификатор тикета
subject Тема тикета
text Текст
plain_text Текст без html
category Категория
priority Приоритет (2 - Нормальный, 3 - Срочный, 1 - Низкий)
status Статус (1 - Новый, 2 - В работе, 3 - Ожидает, 4 - Закрыт)
date_created Дата и время создания тикета
date_modified Дата и время последнего обновления тикета