¶ Додавання фото до оголошення
Тип API: Безкоштовний
Для додавання фотографій до оголошення, Вам необхідно виконати POST запит такого типу:
URL:
curl -X POST "https://developers.ria.com/auto/used/autos/:advertisementId/photos/upload?user_id=ВАШ_ID&api_key=ВАШ_API_КЛЮЧ" -H "content-type: application/json" -H 'Cookie: PSP_ID=ВАШ_PSP_ID' -d '{ "main": "посилання на головне фото", "links": [ "посилання на фото" ]}'
де advertisementId - ідентифікатор оголошення.
Query parameters
| Element | Description | Type | Required |
|---|---|---|---|
| user_id | Ідентифікатор користувача в системі RIA.com | integer | Required |
| api_key | персональний ключ доступу користувача | integer | Required |
Headers
| Header name | Required | Values | Notes |
|---|---|---|---|
| Content-Type | Required | application/json | |
| Cookie | Required | PSP_ID=ВАШ_PSP_ID | детальніше про PSP_ID тут |
POST Body
| Element | Description | Type | Required | Notes | |
|---|---|---|---|---|---|
| main | Посилання на головне фото | Photo data or string | Required | Може бути строкою або об'єктом, в залежності від використання додаткового параметра sortingIndex | |
| url | Посилання на головне фото | string | Required | Має бути присутній формат фото. Можливі формати | |
| sortingIndex | Будь-яке ціле позитивне число | integer | Optional | ||
| links | Фото, які хочете додати | array of data | Required | ||
| url | Посилання на фото | string | Required | У кожному посиланні має бути присутній формат фото. Можливі формати | |
| sortingIndex | Будь-яке ціле позитивне число | integer | Optional |
Фотографії будуть додані не за черговістю, а у випадковому порядку.
Приклад запиту
curl --location --request POST 'https://developers.ria.com/auto/used/autos/ID_оголошення/photos/upload?user_id=ВАШ_ID&api_key=ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--header 'Cookie: PSP_ID=ВАШ_PSP_ID' \
--data-raw --data-raw '{ "main": "https://cdn.example.com/image/1.jpg", "links": [ "https://cdn.example.com/image/2.jpg", "https://cdn.example.com/image/3.jpg" ]}'
або, в більш розгорнутому форматі, з передачею додаткових параметрів:
curl --location --request POST 'https://developers.ria.com/auto/used/autos/ID_оголошення/photos/upload?user_id=ВАШ_ID&api_key=ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--header 'Cookie: PSP_ID=ВАШ_PSP_ID' \
--data-raw '{ "main": { "url": "https://cdn.example.com/image/1.jpg", "sortingIndex": 1 }, "links": [ { "url": "https://cdn.example.com/image/2.jpg", sortingIndex: 2 }, { "url": "https://cdn.example.com/image/3.jpg", "sortingIndex": 3 } ]}'
Приклад успішної відповіді
{"message":"Ok","errors":[]}
¶ Можливі формати фото
Наразі підтримується завантаження зображень наступних форматів:
- jpeg
- webp
- png
- gif
- heic(heif)
Розмір файлу, що завантажується, не повинен перевищувати ліміту в 10Мб (у деяких випадках може бути збільшений до 25Мб).