डेवलपर
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) सत्यापित करना चाहिए।
- प्रत्येक अनुरोध को विधि, पथ, स्थिति, अवधि और कुंजी उपसर्ग के साथ लॉग किया जाता है।