Desenvolvedores
API RefurbScore
API REST para dados de empresas, passaportes, avaliações e integrações de lojistas.
- URL base
https://refurbscore.com
Autenticação
Os endpoints de lojista requerem uma chave de API (plano Pro). Passe sua chave via cabeçalho Authorization Bearer ou X-API-Key.
Authorization: Bearer rs_live_…
# ou
X-API-Key: rs_live_…Role para o lado para ler o comando completo.
Escopos 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. Planos pagos e 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 à URL base. Os endpoints “Públicos” não exigem chave de API e têm limite de requisições por endereço IP.
- GET
/api/company/{slug}Autenticação: PúblicoEscopo:read:company - GET
/api/company/{slug}/scoreAutenticação: PúblicoEscopo:read:company - GET
/api/company/{slug}/reviewsAutenticação: PúblicoEscopo:read:company - GET
/api/passport/{id}Autenticação: PúblicoEscopo:read:passport - POST
/api/passportAutenticação: Chave de APIEscopo:write:passport - POST
/api/reviewsAutenticação: OpcionalEscopo:write:review - POST
/api/suggested-editAutenticação: Chave de APIEscopo:write:edit - POST
/api/webhooksAutenticação: Chave de APIEscopo:write:webhook
Exemplos
curl "https://refurbscore.com/api/company/nomophone"Role 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"}'Role 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"]}'Role 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 de API são armazenadas como hashes SHA-256 — as chaves brutas são mostradas apenas uma vez na criação.
- As entregas de webhook devem verificar X-Webhook-Signature (HMAC-SHA256).
- Cada requisição é registrada com método, caminho, status, duração e prefixo da chave.