Запросы к API

 

Base URL = "https://uapi.qform.io/api"

 

В запросе необходимо передавать подключенный ранее в личном кабинете API-токен в HTTP-заголовке, пример:

Authorization: Bearer код_токена

(ключевое слово Bearer обязательно)

 

GET      /user/me      Получение информации о текущем пользователе

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

{

    "id": user_id,
    "username": "string",
    "email": "string",
    "createdAt": int
}

 

 

GET      /sites/get      Получение сайтов, связанных с токеном

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

{
    "_embedded": {
        "siteDtoList": [
            {
                "id": site_id,
                "name": "string",
                "userId": int,
                "active": int,
                "languageId": int,
                "countryId": int,
                "status": int,
                "isQformLink": int
            }
        ]
    }
}

 

 

GET      /forms/get      Получение форм, связанных с токеном

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

{
    "_embedded": {
        "forms": [
            {
                "id": form_id,
                "name": "string",
                "formId": "string",
                "status": int
            },
            {
                "id": form_id,
                "name": "string",
                "formId": "string",
                "status": int
            }
        ]
    }
}

 

 

GET      /leads/get      Получение всех заявок

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

{

    "_embedded": {
        "leadDataDTOList": [
            {
                "id": lead_id,
                "date": int,
                "formId": int,
                "status": int,
                "formName": "string",
                "fields": {...},
                "leadInfo": {...},
                "userInfo": {...},
                "_links": {...}
            }
        ]
    }
}

 

GET      /leads/get/data/{{lead_id}}      Получение информации о конкретной заявке

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

{

    "id": lead_id,
    "date": int,
    "formId": int,
    "status": int,
    "formName": "string",
    "fields": {...},
    "leadInfo": {...},
    "userInfo": {...}
}

 

 

GET      /forms/{{form_id}}/fields      Получение полей конкретной формы

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

[
    {
        "id": field_id,
        "name": "string",
        "typeId": "string",
        "required": int,
        "label": "string",
        "orderField": int,
        "options": [...]
    }
]

 

Фильтры

Пагинация

Следующий запрос выводит список всех заявок:

GET      /leads/get

 

В этом случае по умолчанию придет список из десяти заявок, а в конце ответа можно увидеть параметры:

  • size – количество заявок на одной странице;
  • totalElements – общее число заявок;
  • totalPages – общее число страниц;
  • number – показатель текущей страницы.

Response Body

{

    "_embedded": {
    "leadDataDTOList": [...]
        },
    "page": {
    "size": int,
    "totalElements": int,
    "totalPages": int,
    "number": int
    }
}

Чтобы изменить вывод, необходимо в запрос включить параметры size и page.

Например, для вывода 20 заявок на второй странице запрос выглядит так:

GET      /leads/get/?size=20&page=2

 

Response Body

{

    "_embedded": {
    "leadDataDTOList": [...]
        },
    "page": {
    "size": 20,
    "totalElements": 55,
    "totalPages": 3,
    "number": 0
    }
}

Меняйте вывод по количеству заявок с помощью параметра size или переходите по страницам, изменяя значение page.

 

GET      /leads/get/{{site_id}}/{{form_id}}      Получение заявок конкретной формы

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

{
    "_embedded": {
        "leadDataDTOList": [
            {
                "id": lead_id,
                "date": int,
                "formId": int,
                "status": int,
                "formName": "string",
                "fields": {...},
                "leadInfo": {...},
                "userInfo": {...},
                "_links": {...}
            }
        ]
    }
}

 

 

GET      /leads/get/?dateFrom={{start_date}}&dateTo={{end_date}}      Получение заявок по интервалу дат

 

Request Headers

Authorization: Bearer код_токена

 

Response Body

{

    "_embedded": {
        "leadDataDTOList": [
            {
                "id": lead_id,
                "date": int,
                "formId": int,
                "status": int,
                "formName": "string",
                "fields": {...},
                "leadInfo": {...},
                "userInfo": {...},
                "_links": {...}
            }
        ]
    }
}

Оставить комментарий