FoxReload API क्विकस्टार्ट गाइड 2026 — 10 मिनट में पहला कॉल
यदि आप एक डिस्ट्रिब्यूटर, मार्केटप्लेस या फिनटेक प्लेटफ़ॉर्म हैं और डिजिटल गुड्स (गेम टॉप-अप, गिफ्ट कार्ड, eSIM) को थोक भाव पर खरीदना चाहते हैं — FoxReload का REST API आपको पूरे कैटलॉग तक 10 मिनट में पहुँच देता है।
यह गाइड आपको पहले सफल API कॉल तक ले जाएगी: ऑथेंटिकेशन, कैटलॉग देखना, और ऑर्डर बनाना।
आपको क्या चाहिए
- FoxReload पार्टनर अकाउंट — sales@foxreload.com पर अनुरोध भेजें या वेबसाइट के माध्यम से रजिस्टर करें।
- API key — डैशबोर्ड में Settings → API Keys सेक्शन में मिलेगी।
- HTTP क्लाइंट — curl, Postman, या आपकी पसंदीदा भाषा (Node.js, Python, Go)।
स्टेप 1: ऑथेंटिकेशन
सभी API रिक्वेस्ट्स के साथ Authorization हेडर भेजें:
curl https://api.foxreload.com/v1/catalog \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"
YOUR_API_KEY को डैशबोर्ड से लिए गए असली key से बदलें। यह key को सुरक्षित रखें — सर्वर-साइड में env variable के रूप में स्टोर करें, क्लाइंट-साइड कोड में कभी न डालें।
स्टेप 2: कैटलॉग देखें
curl https://api.foxreload.com/v1/catalog?limit=10 \
-H "Authorization: Bearer YOUR_API_KEY"
रिस्पॉन्स में 10 SKUs आएंगे — हर SKU में id, name, category, region, wholesale_price_usd, stock_available फील्ड्स। FoxReload के कैटलॉग में 900+ SKUs हैं 34 श्रेणियों में।
स्टेप 3: पहला ऑर्डर
curl https://api.foxreload.com/v1/orders \
-X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sku_id": "psn-tr-100",
"quantity": 1,
"customer_email": "test@yourshop.com"
}'
रिस्पॉन्स में order_id मिलेगा। डिलीवरी आमतौर पर 30 सेकंड के अंदर पूरी होती है — कोड सीधे आपके webhook endpoint पर भेजा जाएगा (देखें: webhook integration गाइड)।
रेट लिमिट्स और एरर हैंडलिंग
- रेट लिमिट: 100 रिक्वेस्ट प्रति मिनट प्रति API key। एक्सीडेंट हो तो
HTTP 429एरर मिलेगी। - एरर कोड्स:
400(खराब रिक्वेस्ट),401(गलत API key),404(SKU नहीं मिला),409(स्टॉक खाली),500(सर्वर एरर)। - रिट्राई:
429और500एरर्स पर exponential backoff के साथ रिट्राई करें।
अगले स्टेप्स
API क्विकस्टार्ट पूरा होने के बाद:
- Webhooks integration — ऑर्डर स्टेटस updates पाएं।
- Catalog pagination — पूरे 900+ SKUs कैटलॉग को pull करें।
- Bulk pricing — वॉल्यूम-आधारित डिस्काउंट्स।
FoxReload पार्टनर बनकर तुरंत API key पाएं और भारत के $32 बिलियन डिजिटल गुड्स बाज़ार में अपनी रिसेलर बिज़नेस लॉन्च करें।