Чести въпроси
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?
- Отидете в "Вашите приложения" и изберете "Редактиране на приложение":
- Попълнете полето "Redirect uri" и запазете промените:
- Можете да дадете повече от един 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 минути. Този лимит е определен от съображения за сигурност, за да се гарантира стабилността на платформата. В случай че този лимит бъде надхвърлен, автоматично ще бъде генерирана следната грешка:
Така, ако IP адресът, използван за изпращане на API повиквания, е локален, максималният брой изпратени API заявки може да бъде 4500 заявки/5 минути. Всяко превишаване на този лимит се блокира автоматично, но блокирането продължава 30 минути. Препоръчваме ви да поддържате броя на повикванията под тези стойности, за да сте сигурни, че няма ограничения, които биха могли да повлияят на процеса на публикуване на рекламите ви.
Ако ситуацията продължава, моля, предоставете ни IP адреса, от който изпращате API повиквания, за да проверим и да се уверим, че той не присъства в централен черен списък, както и идентификатора на заявката, която е била отхвърлена с грешка 403.