Програмери
API на RefurbScore
REST API за податоци за компании, паспорти, рецензии и интеграции на продавачи.
- Основен URL
https://refurbscore.com
Удостоверjaване
Крайните точки на трговеца изискват API клjuч (професионален план). Предайте своja клjuч чрез носител на разрешение или заглавка на X-API-Key.
Authorization: Bearer rs_live_…
# или
X-API-Key: rs_live_…Лизгајте настрана за да ја прочитате целата команда.
Налични обхвати:
read:companyread:passportwrite:passportwrite:reviewwrite:editwrite:webhook
Оценка на независимостта
API излага резултати за доверба, изчислени от проверени данни. Платените планове и API достпт никога не променjaт резултатите.
Ограничениja на скоростта
- Публични четениja
- 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 клjuчОбхват:write:passport - POST
/api/reviewsавт: Не е задлжителноОбхват:write:review - POST
/api/suggested-editавт: API клjuчОбхват:write:edit - POST
/api/webhooksавт: API клjuчОбхват: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"]}'Лизгајте настрана за да ја прочитате целата команда.
сбитиja
review.createdreview.publishedpassport.createdpassport.publishedscore.updatedcertification.updated
сигурност
- Всички операции по писане влизат в администраторска модерациja преди публикуване.
- API клjuчовете се схранjaват като SHA-256 хешове — необработените клjuчове се показват веднж при сздаване.
- Испораките на webhook треба да го проверуваат X-Webhook-Signature (HMAC-SHA256).
- Всjaка заjaвка се регистрира с метод, пт, статус, продлжителност и префикс на клjuч.