Plataforma para developers
Integra com o marketplace Troko — cria anuncios, pesquisa catalogos, recebe webhooks em tempo real e automatiza o teu negocio com a API REST v1.
A API Publica do Troko e uma API REST que permite aceder programaticamente ao marketplace — listar anuncios, pesquisar catalogos, obter estatisticas e (para contas PRO) criar e gerir anuncios via codigo.
Base URL: https://troko.pt/api/v1/public
Todas as respostas sao JSON. O encoding e UTF-8. Datas seguem ISO 8601.
Endpoints
8
REST v1
Autenticacao
API Key
Header X-API-Key
Rate Limit
1k-10k/h
FREE / PRO
Formato
JSON
UTF-8, ISO 8601
Todos os endpoints requerem uma API key valida enviada no header HTTP:
X-API-Key: trk_your_api_key_hereComo obter uma API key:
Os limites de pedidos dependem do tier da tua conta. Quando o limite e excedido, a API devolve HTTP 429 com o header Retry-After.
| Tier | Limite | Escrita | Nota |
|---|---|---|---|
| FREE | 1 000 req/hora | Nao | Leitura apenas |
| PRO | 10 000 req/hora | Sim | Leitura + escrita |
| Stats | 120 req/hora | N/A | Endpoint /stats (todos os tiers) |
Headers de rate limit incluidos em cada resposta:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1717329600| HTTP | Significado |
|---|---|
| 200 | Sucesso |
| 201 | Recurso criado |
| 400 | Dados invalidos (validacao) |
| 401 | API key ausente ou invalida |
| 403 | Permissoes insuficientes (scope ou tier) |
| 404 | Recurso nao encontrado |
| 429 | Rate limit excedido |
| 500 | Erro interno do servidor |
Formato de erro
{
"statusCode": 401,
"message": "API key invalida ou ausente",
"error": "Unauthorized"
}Clica num endpoint para ver o pedido curl e a resposta esperada.
JavaScript / TypeScript
npm install @troko/sdkPython
pip install trokocURL / HTTP
Qualquer cliente HTTP funciona — basta enviar o header X-API-Key.