हब की हर API एक ही gateway के ज़रिए, एक ही key और एक जैसे response headers के साथ कॉल होती है।
यह पेज उन developers के लिए है जो अपने कोड से APIs कॉल करते हैं। AI एजेंट इस्तेमाल कर रहे हैं? आपको इसमें से कुछ नहीं चाहिए: देखें AI एजेंट कनेक्ट करें (MCP)।
पहली कॉल से पहले
- अपनी API key लें।
- कैटलॉग में API खोलें और किसी plan को subscribe करें (या, अगर उसमें free trial है, तो उसे शुरू करें)। जिस API को आपने subscribe नहीं किया है, उसकी कॉल्स को
401मिलता है।
URL फॉर्मेट
https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}
API पेज Endpoints सेक्शन में यह URL आपके लिए बना देता है, हर endpoint के parameters और 15 प्रोग्रामिंग भाषाओं (cURL, JavaScript, Node.js, Python, PHP, Java, Go, C# और अन्य) में code samples के साथ। इसे हाथ से बनाने के बजाय वहीं से कॉपी करें।
Query parameters (GET)
curl 'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}[email protected]' \
-H 'Authorization: Bearer YOUR_API_KEY'
const res = await fetch(
'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}[email protected]',
{ headers: { Authorization: `Bearer ${process.env.ZYLA_API_KEY}` } }
);
const data = await res.json();
import os, requests
r = requests.get(
"https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}",
params={"email": "[email protected]"},
headers={"Authorization": f"Bearer {os.environ['ZYLA_API_KEY']}"},
)
print(r.status_code, r.json())
JSON body (POST)
endpoint पर दिखाया गया method इस्तेमाल करें। किसी दूसरे method पर 401 के साथ Invalid method मिलता है।
curl -X POST 'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"text": "Hello world"}'
Response headers
हर सफल response में आपका usage शामिल होता है, ताकि आप अपनी तरफ से throttle कर सकें:
| Header | मतलब |
|---|---|
X-Zyla-API-Calls-Monthly-Used |
इस subscription के मौजूदा billing cycle में इस्तेमाल हुई calls |
X-Zyla-API-Calls-Monthly-Remaining |
साइकिल में बची calls |
X-Zyla-API-Calls-Monthly-Limit |
आपके plan में शामिल calls |
X-Zyla-RateLimit-Remaining |
मौजूदा मिनट में बची requests |
X-Zyla-RateLimit-Reset-Seconds |
per-minute window रीसेट होने में बचे सेकंड |
Body प्रोवाइडर का response है, जैसा है वैसा लौटाया जाता है। gateway की अपनी एरर्स के लिए (subscription न होना, limits, अनजान endpoint), देखें प्लान, लिमिट और एरर।
