Desarrolladores
API de RefurbScore
- URL base
https://refurbscore.com
Autenticación
Los endpoints de vendedor requieren una clave API (plan Pro). Pasa tu clave mediante el encabezado Authorization Bearer o X-API-Key.
Authorization: Bearer rs_live_…
# o
X-API-Key: rs_live_…Desplázate hacia los lados para leer el comando completo.
Ámbitos disponibles:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Independencia de puntuación
La API expone puntuaciones de confianza calculadas a partir de datos verificados. Los planes de pago y el acceso a la API nunca modifican las puntuaciones.
Límites de velocidad
- Lecturas públicas
- 60req/min
- Autenticado
- 300req/min
- Operaciones de escritura
- 30req/min
Las respuestas incluyen los encabezados X-RateLimit-Remaining y X-RateLimit-Reset.
Endpoints
Las rutas son relativas a la URL base. Los endpoints «Públicos» no necesitan clave de API y tienen un límite de peticiones por dirección IP.
- GET
/api/company/{slug}Auth: PúblicoÁmbito:read:company - GET
/api/company/{slug}/scoreAuth: PúblicoÁmbito:read:company - GET
/api/company/{slug}/reviewsAuth: PúblicoÁmbito:read:company - GET
/api/passport/{id}Auth: PúblicoÁmbito:read:passport - POST
/api/passportAuth: Clave APIÁmbito:write:passport - POST
/api/reviewsAuth: OpcionalÁmbito:write:review - POST
/api/suggested-editAuth: Clave APIÁmbito:write:edit - POST
/api/webhooksAuth: Clave APIÁmbito:write:webhook
Ejemplos
curl "https://refurbscore.com/api/company/nomophone"Desplázate hacia los lados para leer el 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"}'Desplázate hacia los lados para leer el 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"]}'Desplázate hacia los lados para leer el comando completo.
Eventos
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Seguridad
- Todas las operaciones de escritura entran en moderación admin antes de su publicación.
- Las claves API se almacenan como hashes SHA-256 — las claves sin procesar se muestran una sola vez al crearse.
- Las entregas de webhook deben verificar X-Webhook-Signature (HMAC-SHA256).
- Cada solicitud se registra con método, ruta, estado, duración y prefijo de clave.