LetBuyy JSON उत्तर देने वाला REST API है। हर दुकान की अलग site_id होती है और सीमित क्षमताओं वाली API कुंजी से प्रोग्राम द्वारा पहुँच सकते हैं।
प्रमाणीकरण

API Bearer टोकन इस्तेमाल करता है। व्यापारी नियंत्रण केंद्र में Settings → Developer → API Keys से कुंजी बनाएँ। कार्यक्षेत्र केवल पढ़ना, पढ़ना-लिखना या admin हो सकता है।
curl -X GET \
https://api.letbuyy.com/v1/products \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Site-ID: your_site_id"मुख्य एंडपॉइंट
| संसाधन | एंडपॉइंट | तरीके |
|---|---|---|
| उत्पाद | /v1/products | GET, POST, PUT, DELETE |
| ऑर्डर | /v1/orders | GET, PUT |
| ग्राहक | /v1/customers | GET, POST, PUT |
| इन्वेंटरी | /v1/inventory | GET, PUT |
| संग्रह | /v1/collections | GET, POST, PUT, DELETE |
दर सीमाएँ
- सामान्य: हर साइट के लिए प्रति सेकंड 100 अनुरोध
- बर्स्ट: किसी भी 5-सेकंड अवधि में 250 अनुरोध
- दर सीमा हेडर: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- सीमा पार करने पर 429—घातीय बैकऑफ लागू करें
पेज में परिणाम

GET /v1/products?limit=50&cursor=eyJpZCI6MTIzfQ
// Response
{
"data": [...],
"pagination": {
"next_cursor": "eyJpZCI6MTczfQ",
"has_more": true
}
}इडेम्पोटेंसी कुंजियाँ
ऑर्डर या उत्पाद बनाने वाले POST अनुरोध में Idempotency-Key हेडर भेजें। 24 घंटे में वही कुंजी फिर आए तो API प्रतिलिपि बनाने के बजाय मूल उत्तर देता है।
त्रुटियाँ
- 400 Bad Request: गलत पैरामीटर—उत्तर का error.field जाँचें
- 401 Unauthorized: अमान्य या समाप्त API कुंजी
- 403 Forbidden: कुंजी सही, लेकिन कार्यक्षेत्र अपर्याप्त
- 404 Not Found: इस site_id में संसाधन मौजूद नहीं
- 429 Too Many Requests: दर सीमा पार
- 500 Internal Server Error: LetBuyy की त्रुटि—बैकऑफ के साथ फिर प्रयास करें


