Portal Deweloperski

Częste pytania

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. Dlaczego refresh_token wygasł?

Refresh token jest ważny jeden miesiąc (2592000 sekund) i wygasa po tym czasie - nie ma możliwości wygenerowania wiecznego refresh tokenu. Może on także zostać zmieniony po wygenerowaniu nowego access tokenu. Wówczas wymagane jest zaktualizowanie tokenu.

5. Jak ustawić callback URL?

• Przejdź do zakładki "Twoje aplikacje" i wybierz "Edytuj Aplikację":
  
  
  
  
• Wypełnij pole "Adres powrotu" i zapisz zmiany:
  
  
  
  
• Możesz podać więcej niż jeden adres powrotu jeśli potrzebujesz. Aby to zrobić, oddziel je spacją.

6. Czy mogę użyć API do pobierania informacji o ogłoszeniach innych użytkowników?

Nie jest to możliwe - możesz zarządzać wyłącznie ogłoszeniami na swoim koncie OLX.

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

Problem jest związany z "grant_type", którego używasz w żądaniu, jeśli Twoje konto API nie może używać określonego "grant_type". W pierwszej kolejności sprawdź czy "grant_type" jest prawidłowy. Jeśli wszystko wygląda dobrze, ale problem nadal występuje - skontaktuj się z nami.

8. Jak mogę zarządzać swoimi ogłoszeniami w różnych krajach?

Możesz zarządzać swoimi ogłoszeniami w niżej wymienionych krajach:

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. Jak mogę testować API? Czy zapewniacie środowisko testowe?

Niestety nie zapewniamy środowiska dla testowania API. Możesz użyć innego konta OLX lub utworzyć nowe do celów testowych i to na nim przeprowadzać próby.

10. W jakich kategoriach mogę dodawać ogłoszenia?

Niektóre kategorie mogą być wyłączone z możliwości dodawania w nich ogłoszeń (na przykład kategoria Nieruchomości w OLX.pl lub kategorie bezpłatne). Jeśli nie masz pewności czy dana kategoria może być zarządzana przez API, skontaktuj się z nami.

Kategorie, w których można dodawać ogłoszenia poprzez API w OLX.pl:
- 4 (Praca)
- 5 (Motoryzacja)
- 87 (Moda)
- 88 (Dla Dzieci)
- 99 (Elektronika)
- 103 (Zwierzęta)
- 628 (Dom i Ogród)
- 751 (Muzyka i Edukacja)
- 757 (Rolnictwo)
- 767 (Sport i Hobby)
- 4371 (Usługi)

11. Czy istnieje maksymalna liczba zapytań akceptowanych przez OLX API w danym przedziale czasowym?

OLX API zezwala na wykonanie maksymalnie 4500 zapytań, które mogą być wysłane z danego adresu IP w ciągu 5 minut. Limit ten jest ustalony ze względów bezpieczeństwa, aby zapewnić stabilność serwisu. W przypadku przekroczenia tego limitu, automatycznie zostanie wygenerowany następujący błąd:

Jeśli więc dany adres IP używany do odpytywania OLX API jest adresem lokalnym, maksymalna liczba wysyłanych zapytań może wynosić 4500 w ciągu 5 minut. Każde przekroczenie tego limitu jest automatycznie blokowane, a blokada trwa 30 minut. Zalecamy utrzymywanie liczby zapytań poniżej tych wartości, aby mieć pewność, że nie występują ograniczenia, które mogłyby wpłynąć na proces zamieszczania ogłoszeń.

Jeśli sytuacja się powtarza, skontaktuj się z nami i przekaż nam adres IP, z którego odpytujesz OLX API, w celu sprawdzenia i upewnienia się, że nie znajduje się on na liście niezaufanych adresów, a także Request ID zwracany wraz z błędem 403.