Розробникам
API RefurbScore
REST API для даних компаній, паспортів, відгуків та інтеграцій продавців.
- Базова URL-адреса
https://refurbscore.com
Автентифікація
Кінцеві точки для продавців вимагають API-ключа (тарифний план Pro). Передайте ключ через заголовок Authorization Bearer або X-API-Key.
Authorization: Bearer rs_live_…
# або
X-API-Key: rs_live_…Прокрутіть убік, щоб прочитати команду повністю.
Доступні обсяги:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Незалежність оцінки
API надає оцінки довіри, розраховані на основі верифікованих даних. Платні плани та доступ до API ніколи не змінюють оцінки.
Обмеження запитів
- Публічні запити
- 60запит/хв
- Автентифіковані
- 300запит/хв
- Операції запису
- 30запит/хв
Відповіді включають заголовки X-RateLimit-Remaining і X-RateLimit-Reset.
Кінцеві точки
Шляхи вказано відносно базової URL-адреси. Для «публічних» ендпоінтів ключ API не потрібен, а кількість запитів обмежено для кожної IP-адреси.
- GET
/api/company/{slug}Автентифікація: ПублічнийОбсяг:read:company - GET
/api/company/{slug}/scoreАвтентифікація: ПублічнийОбсяг:read:company - GET
/api/company/{slug}/reviewsАвтентифікація: ПублічнийОбсяг:read:company - GET
/api/passport/{id}Автентифікація: ПублічнийОбсяг:read:passport - POST
/api/passportАвтентифікація: API-ключОбсяг:write:passport - POST
/api/reviewsАвтентифікація: Необов'язковоОбсяг:write:review - POST
/api/suggested-editАвтентифікація: API-ключОбсяг:write:edit - POST
/api/webhooksАвтентифікація: API-ключОбсяг:write:webhook
Приклади
curl "https://refurbscore.com/api/company/nomophone"Прокрутіть убік, щоб прочитати команду повністю.
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"}'Прокрутіть убік, щоб прочитати команду повністю.
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"]}'Прокрутіть убік, щоб прочитати команду повністю.
Події
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
Безпека
- Усі операції запису проходять модерацію адміном перед публікацією.
- API-ключі зберігаються у вигляді хешів SHA-256 — необроблені ключі відображаються один раз при створенні.
- Доставки webhook слід перевіряти за допомогою X-Webhook-Signature (HMAC-SHA256).
- Кожен запит реєструється з методом, шляхом, статусом, тривалістю та префіксом ключа.