개발자
RefurbScore API
회사 데이터, 패스포트, 리뷰, 판매자 통합을 위한 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)를 확인해야 합니다.
- 모든 요청은 메서드, 경로, 상태, 기간, 키 접두사와 함께 기록됩니다.