Programadores
API RefurbScore
API REST para dados de empresas, passaportes, avaliações e integrações de comerciantes.
- URL de base
https://refurbscore.com
Autenticação
Os endpoints de comerciante requerem uma chave API (plano Pro). Passe a sua chave via cabeçalho Authorization Bearer ou X-API-Key.
Authorization: Bearer rs_live_…
# ou
X-API-Key: rs_live_…Desloque para o lado para ler o comando completo.
Âmbitos disponíveis:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Independência da pontuação
A API expõe pontuações de confiança calculadas a partir de dados verificados. Os planos pagos e o acesso à API nunca modificam as pontuações.
Limites de taxa
- Leituras públicas
- 60req/min
- Autenticado
- 300req/min
- Operações de escrita
- 30req/min
As respostas incluem os cabeçalhos X-RateLimit-Remaining e X-RateLimit-Reset.
Endpoints
Os caminhos são relativos ao URL de base. Os endpoints «Públicos» não precisam de chave de API e têm um limite de pedidos por endereço IP.
- GET
/api/company/{slug}Autenticação: PúblicoÂmbito:read:company - GET
/api/company/{slug}/scoreAutenticação: PúblicoÂmbito:read:company - GET
/api/company/{slug}/reviewsAutenticação: PúblicoÂmbito:read:company - GET
/api/passport/{id}Autenticação: PúblicoÂmbito:read:passport - POST
/api/passportAutenticação: Chave APIÂmbito:write:passport - POST
/api/reviewsAutenticação: OpcionalÂmbito:write:review - POST
/api/suggested-editAutenticação: Chave APIÂmbito:write:edit - POST
/api/webhooksAutenticação: Chave APIÂmbito:write:webhook
Exemplos
curl "https://refurbscore.com/api/company/nomophone"Desloque para o lado para ler o comando completo.
curl -X POST "https://refurbscore.com/api/passport" \
-H "Authorization: Bearer rs_live_…" \
-H "Content-Type: application/json" \
-d '{"brand":"Apple","model":"iPhone 13","condition":"A","summary":"128GB"}'Desloque para o lado para ler o comando completo.
curl -X POST "https://refurbscore.com/api/webhooks" \
-H "Authorization: Bearer rs_live_…" \
-H "Content-Type: application/json" \
-d '{"action":"register","url":"https://example.com/hook","events":["review.published"]}'Desloque para o lado para ler o comando completo.
Eventos
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Segurança
- Todas as operações de escrita entram na moderação de administrador antes da publicação.
- As chaves API são armazenadas como hashes SHA-256 — as chaves em bruto são mostradas apenas uma vez na criação.
- As entregas de webhook devem verificar X-Webhook-Signature (HMAC-SHA256).
- Cada pedido é registado com método, caminho, estado, duração e prefixo da chave.