API «История АО»

Версия 1.9 · 21.07.2026 · ООО «АвтоОнлайн»

Короткая инструкция для получения данных об участии автомобиля в аукционах Avtoonline и фотографий. API использует GraphQL: все запросы отправляются методом POST на один адрес.

1. Быстрый старт

1. Получите у контактного лица Avtoonline значения partyid и password.
2. Выполните POST /api/login и сохраните JWT-токен. Токен действует 7 суток.
3. Возьмите accessId из выданного пакета доступа.
4. Отправьте GraphQL-запрос на POST /api/graphql-data.
5. Во всех запросах к GraphQL передавайте Authorization: Bearer <token>.

Схема вызова

2. Адреса

К базовому адресу добавьте /api/login для входа или /api/graphql-data для GraphQL-запросов.

3. Получение JWT-токена

curl -X POST https://int-graphql.avtoonline.tech/api/login \
  -H "Content-Type: application/json" \
  -d '{"partyid":"<PARTY_ID>","password":"<PASSWORD>"}'

Успешный ответ:

{
  "token": "<JWT_TOKEN>",
  "party": {
    "accessPackages": [
      {
        "id": "<ACCESS_ID>"
      }
    ]
  }
}

4. Запрос истории по VIN

curl -X POST https://int-graphql.avtoonline.tech/api/graphql-data \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer <JWT_TOKEN>" \
  -d '{
    "query": "query History($vin:String!,$accessId:String!){getCarHistoryPackage(vin:$vin,accessId:$accessId){vin avtoonline photos}}",
    "variables": {"vin":"<VIN>","accessId":"<ACCESS_ID>"}
  }'

Поля avtoonline и photos возвращаются как JSON-строки. Их нужно распарсить на стороне клиента. Значение null означает, что секция недоступна, не запрошена или по автомобилю нет данных.

{
  "data": {
    "getCarHistoryPackage": {
      "vin": "<VIN>",
      "avtoonline": "{\"value\":[],\"success\":true}",
      "photos": null
    }
  }
}

5. Проверка пакета доступа

Запрос getAccessPackage возвращает параметры пакета и журнал использования. Query оформлен одним блоком:

{
  "query": `
    query GetMyAccessPackage($accessId:String!,$offset:Int!,$limit:Int!,$vin:String) {
      getAccessPackage(id:$accessId) {
        id
        downloadsTotal
        startDate
        endDate
        downloadsRemaining
        dataSet
        dataSetAvtoonline
        usageLogs(offset:$offset,limit:$limit,sortOrder:"desc",vinPart:$vin) {
          totalCount
          offset
          limit
          logs {
            timestamp
            accessPackageId
            vin
            deducted
          }
        }
      }
    }
  `,
  "variables": {
    "accessId": "<ACCESS_ID>",
    "offset": 0,
    "limit": 50,
    "vin": null
  }
}

6. Ошибки

Для Sandbox действует ограничение 5 RPS и 2 000 запросов в сутки. Для Production используйте согласованные для вашего пакета лимиты.

7. Поддержка

Технические вопросы: hello@avtoonline.pro. Интерактивная схема Sandbox: https://int-graphql.avtoonline.tech/api/sandbox-data.