LetBuyy API என்பது 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
}
}Idempotency விசைகள்
ஆர்டர் அல்லது தயாரிப்பை உருவாக்கும் 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 பிழை—இடைவெளியிட்டு மீண்டும் முயலுங்கள்
