Портал розробників

Часті запитання

1. "Invalid owner in token"

The problem occurs when you are authorized with "grant_type": "client_credentials" and you are trying to perform actions in the OLX user context, for example: adding the ad or checking out account balance. In this situation you have to authorize yourself with "grant_type": "autorization_code".

2. Content-Type: application/json

If you use a GET request, do not use the "Content-Type": "application/json" header - it is dedicated to PUT, POST request. Otherwise, you will stumble upon 400 Bad Request Error.

3. "Missing required header"

This error means that there is no version header in your request. It is necessary in some requests. For example: if you are using API v2, there should be "Version": "2.0" header in your request.

4. Чому сплив термін дії refresh_token?

Токен оновлення дійсний протягом одного місяця (2592000 секунд) і термін його дії після цього закінчується — можливості згенерувати вічний токен оновлення немає. Його можна змінити, коли генерується новий токен доступу. Вам може знадобитися оновити токен доступу та токен оновлення у вашій базі даних. Будь ласка, тримайте їх в секреті.

5. Як налаштувати callback URL?

• Перейдіть в розділ "Ваші додатки" і виберіть "Редагувати додаток":
  
  
  
  
• Заповніть поле "Переспрямувати URL" і збережіть зміни:
  
  
  
  
• Ви можете вказати більш як один URL, якщо це необхідно. Для цього розділіть їх пробілами.

6. Чи можу я використовувати API для доступу до оголошень інших людей?

Це неможливо — ви можете керувати лише власними оголошеннями, що були додані у ваш авторизований обліковий запис OLX.

7. "The grant type is unauthorized for this client_id"

Проблема пов'язана з "grant_type", який ви використовуєте в запиті, якщо вашому обліковому запису API не дозволено використовувати певний тип надання. Спочатку перевірте, чи дійсний тип гранту. Якщо все виглядає добре, але ви постійно натикаєтеся на цю помилку - зв'яжіться з нами.

8. Як я можу керувати своїми оголошеннями в різних країнах?

Ви можете керувати своїми оголошеннями через API в країнах, перерахованих нижче:

OLX PL	https://www.olx.pl/
OLX BG	https://www.olx.bg/
OLX RO	https://www.olx.ro/
OLX PT	https://www.olx.pt/
OLX UA	https://www.olx.ua/
OLX KZ	https://www.olx.kz/

Note that client_id and client_secret allow you to manage your ads only for one country. If you would like to manage your ads in another country, you have to authorize OLX account created in a given country where you want to manage the ads. Then you will get new credentials.

9. Як я можу протестувати API? Чи надаєте ви тестове середовище?

На жаль, ми не надаємо тестове середовище в API. Ви можете використовувати інший обліковий запис OLX або створити новий і авторизувати його для тестування запитів API.

10. В яких категоріях я можу розмістити оголошення?

Деякі категорії можуть бути виключені з додавання оголошень залежно від країни (наприклад: нерухомість або безкоштовні категорії в Польщі). Якщо ви не впевнені, чи зможете розмістити оголошення в певній категорії, зв’яжіться з нами.

11. Чи існує максимальна кількість викликів, які API OLX може прийняти протягом певного періоду часу?

Система OLX API дозволяє надсилати максимум 4500 запитів, які можуть бути надіслані через IP користувача протягом 5 хвилин. Це обмеження встановлюється з міркувань безпеки, щоб забезпечити стабільність платформи. У разі перевищення цієї межі автоматично згенерується наступна помилка:

Таким чином, якщо IP-адреса, яка використовується для надсилання викликів API, є локальною, максимальна кількість надісланих запитів API може становити 4500 запитів/5 хвилин. Будь-яке перевищення цієї межі автоматично блокується, але блокування триває 30 хвилин. Ми рекомендуємо залишати кількість дзвінків нижче цих значень, щоб переконатися, що немає обмежень, які можуть вплинути на процес розміщення оголошень.

Якщо ситуація не зникне, надайте нам IP-адресу, з якої ви надсилаєте виклики API, щоб перевірити та переконатися, що вона не міститься в центральному чорному списку, а також ідентифікатор запиту, який було відхилено через помилку 403.