История АО: аукционы и фотографии

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

Инструкция описывает только три секции истории автомобиля: auctions, avtoonline и photos.

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

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

Получение токена

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>"
      }
    ]
  }
}

2. Запрос по 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 Auctions($vin:String!,$accessId:String!){getCarHistoryPackage(vin:$vin,accessId:$accessId){vin completed auctions avtoonline photos}}",
    "variables": {"vin":"<VIN>","accessId":"<ACCESS_ID>"}
  }'

{
  "data": {
    "getCarHistoryPackage": {
      "vin": "<VIN>",
      "completed": false,
      "auctions": null,
      "avtoonline": "{\"status\":\"in_progress\",\"success\":false}",
      "photos": null
    }
  }
}

3. Запрос с заказом

getCarHistoryPackageV2 возвращает orderId. Используйте его для всех повторных запросов одного отчёта.

{
  "query": `
    query AuctionsV2($vin:String!,$accessId:String!) {
      getCarHistoryPackageV2(vin:$vin,accessId:$accessId) {
        order {
          id
          expiresAt
          requestLimit
          requestsUsed
        }
        package {
          vin
          completed
          auctions
          avtoonline
          photos
        }
      }
    }
  `,
  "variables": {
    "vin": "<VIN>",
    "accessId": "<ACCESS_ID>"
  }
}

Первый вызов выполняется без orderId. В повторном вызове добавьте переменную orderId и аргумент orderId: $orderId. Не меняйте VIN и accessId внутри одного заказа.

4. Запрос по государственному номеру

{
  "query": `
    query AuctionsByReg($reg:String!,$accessId:String!) {
      getCarHistoryPackageByRegNumber(regNumber:$reg,accessId:$accessId) {
        vin
        completed
        auctions
        avtoonline
        photos
      }
    }
  `,
  "variables": {
    "reg": "<ГОСНОМЕР>",
    "accessId": "<ACCESS_ID>"
  }
}

Для повторных обращений с заказом используйте getCarHistoryPackageByRegNumberV2. Возможность поиска по VIN или госномеру определяется настройкой пакета доступа.

5. Как читать ответ

auctions, avtoonline и photos — JSON-строки. После парсинга секция обычно содержит:

{
  "value": [],
  "success": true,
  "status": "completed",
  "checkDateTime": "2026-07-21T10:00:00Z",
  "createdDateTime": "2026-07-21T10:00:00Z"
}

• auctions.value — история размещений на аукционах.
• avtoonline.value — участие в аукционах Avtoonline.
• photos.value — фотографии, включая url и urlValidTill.

null допустим, если секция не входит в пакет, ещё не готова или данные не найдены. Временную ссылку на фотографию используйте только до urlValidTill.

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

{
  "query": `
    query Access($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
  }
}

7. Polling и ошибки

completed: false не является ошибкой. Повторяйте тот же запрос через 5–30 секунд. Для методов *V2 передавайте тот же orderId.

8. Поддержка

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