Разработчици
API на RefurbScore
REST API за фирмени данни, паспорти, прегледи и интеграции на търговци.
- Базов URL
https://refurbscore.com
Удостоверяване
Крайните точки на търговеца изискват API ключ (професионален план). Предайте своя ключ чрез носител на разрешение или заглавка на X-API-Key.
Authorization: Bearer rs_live_…
# или
X-API-Key: rs_live_…Превъртете настрани, за да прочетете цялата команда.
Налични обхвати:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Оценка на независимостта
API излага резултати за доверие, изчислени от проверени данни. Платените планове и API достъпът никога не променят резултатите.
Ограничения на скоростта
- Публични четения
- 60req/min
- Удостоверен
- 300req/min
- Операции за писане
- 30req/min
Отговорите включват заглавките 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).
- Всяка заявка се регистрира с метод, път, статус, продължителност и префикс на ключ.