Портал за програмисти

Чести въпроси

1. "Invalid owner in token"

Проблемът възниква, когато сте оторизиран с "grant_type": "client_credentials" и се опитвате да извършвате действия в контекста на OLX потребител, например: добавяне на обява или проверка на баланс в акаунта. В тази ситуация трябва да се оторизирате с "grant_type": "autorization_code".


2. Content-Type: application/json

Ако използвате GET заявка, не използвайте "Content-Type": "application/json" - то се отнася се до PUT и POST заявки . В противен случай ще получите 400 Bad Request Error.


3. "Missing required header"

Тази грешка означава, че в хедъра на заявката липсва информация за версията. Необходимо е при някои заявки. Например: Ако използвате API v2, трябва да добавите "Version": "2.0" в хедъра на заявката.


4. Защо refresh_token е изтекъл?

Токенът за опресняване е валиден един месец (2592000 секунди) и изтича след този период - няма възможност за генериране на вечен refresh token. Той може да бъде променен, когато се генерира нов токен за достъп. Може да се наложи да актуализирате токенa за достъп и да go опресните в базата си данни. Моля, пазете ги.


5. Как да настроите callback URL?


6. Мога ли да използвам API да чета обяви на други потребители?

Не е възможно - можете да менажирате само собствените си обяви, добавени в оторизирания OLX акаунт.


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

Проблемът е свързан с "grant_type", който използвате в заявката, ако на профила ви в API не е разрешено да използва определен тип грант. Първо проверете дали типът грант е валиден. Ако всичко изглежда наред, но постоянно се натъквате на тази грешка - свържете се с нас.


8. Как мога да управлявам обявите си в различни страни?

Можете да управлявате своите обяви в следните държави:

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/

Имайте предвид, че client_id и client_secret ви позволяват да управлявате обявите си само за една държава. Ако искате да управлявате обявите си в друга държава, трябва да оторизирате OLX акаунт, създаден в държавата, в която искате да публикувате. За нея ще получите отделни, нови данни за достъп.


9. Как мога да тествам API? Предоставяте ли тест среда?

За съжаление, не можем да предоставим тест среда в API. Можете да използвате различен или да създадете нов акаунт с цел да тествате API заявките.


10. В кои категории мога да публикувам обяви?

Някои категории могат да бъдат изключени от добавянето на реклами в зависимост от страната (например: категории за недвижими имоти или безплатни категории в Полша). Ако не сте сигурни дали ще можете да публикувате обяви в дадена категория, моля, свържете се с нас.


11. Има ли максимален брой повиквания, които OLX API приема за определен период от време?

Системата OLX API позволява максимум 4500 заявки, които могат да бъдат изпратени от IP адреса на даден потребител в рамките на 5 минути. Този лимит е определен от съображения за сигурност, за да се гарантира стабилността на платформата. В случай че този лимит бъде надхвърлен, автоматично ще бъде генерирана следната грешка:


Rate limits

Така, ако IP адресът, използван за изпращане на API повиквания, е локален, максималният брой изпратени API заявки може да бъде 4500 заявки/5 минути. Всяко превишаване на този лимит се блокира автоматично, но блокирането продължава 30 минути. Препоръчваме ви да поддържате броя на повикванията под тези стойности, за да сте сигурни, че няма ограничения, които биха могли да повлияят на процеса на публикуване на рекламите ви.

Ако ситуацията продължава, моля, предоставете ни IP адреса, от който изпращате API повиквания, за да проверим и да се уверим, че той не присъства в централен черен списък, както и идентификатора на заявката, която е била отхвърлена с грешка 403.