Portal de Developers OLX

FAQ

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. Porque é que o refresh_token expirou?

O refresh_token é válido durante um mês (2592000 segundos) e expira após este período - não é possível gerar um token sem validade. O refresh_token também pode ser alterado quando um novo token de acesso é gerado. Neste caso, deve actualizar o token de acesso e o token de refresh na sua base de dados. Por favor, mantenha-os em segurança.

5. Como configurar o callback URL?

Vá à secção "My Apps" e seleccione "Editar App":
Preencha o campo "Redirect uri" e guarde as alterações:
Se for necessário, pode preencher mais do que um URL. Para fazê-lo, separe cada URL com um espaço.

6. Posso usar a API para ler anúncios de outros utilizadores?

Não é possível - apenas pode gerir os anúncios publicados através da sua conta autorizada OLX.

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

O problema está relacionado com o "grant_type" que está a utilizar num pedido se a sua conta API não estiver autorizada a utilizar um tipo específico de subvenção. Verifique primeiro se o tipo de subvenção é válido. Se tudo parecer bem mas tropeçar constantemente neste erro - contacte-nos.

8. Como posso gerir os meus anúncios em países diferentes?

Pode gerir os seus anúncios via API nos países listados abaixo:

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. Como posso testar a API? O OLX tem ambiente de testes?

Infelizmente, ainda não temos ambiente de teste para API. No entanto, poderá usar outra conta OLX ou criar uma nova e autorizá-la para que possa efectuar os seus testes.

10. Em quais categorias posso publicar anúncios?

Algumas categorias podem ser excluídas de adicionar os anúncios dependendo do país (por exemplo: Imobiliário ou categorias gratuitas na Polónia). Se não tiver a certeza se poderá publicar os anúncios numa determinada categoria, por favor contacte-nos.

11. Existe um número máximo de chamadas que o OLX API aceita durante um período de tempo?

O sistema OLX API permite um máximo de 4500 pedidos que podem ser enviados por um IP do utilizador dentro de 5 minutos. Este limite é estabelecido por razões de segurança para assegurar a estabilidade da plataforma. No caso deste limite ser ultrapassado, será gerado automaticamente o seguinte erro:

Assim, se o IP utilizado para enviar chamadas API for local, o número máximo de pedidos API enviados pode ser de 4500 pedidos/5 minutos. Qualquer ultrapassagem deste limite é automaticamente bloqueada, mas o bloqueio dura 30 minutos. Recomendamos manter o número de chamadas abaixo destes valores para garantir que não existem limitações que possam afectar o processo de publicação dos seus anúncios.

Se a situação persistir, queira fornecer-nos o IP a partir do qual está a enviar chamadas API, para verificar e assegurar que não está presente numa lista negra central, bem como uma ID de pedido que foi recusada com o erro 403.