# HTTP से API कॉल करें

हब की हर API एक ही gateway के ज़रिए, एक ही key और एक जैसे response headers के साथ कॉल होती है।

> यह पेज उन developers के लिए है जो अपने कोड से APIs कॉल करते हैं। AI एजेंट इस्तेमाल कर रहे हैं? आपको इसमें से कुछ नहीं चाहिए: देखें [AI एजेंट कनेक्ट करें (MCP)](https://zylalabs.com/hi/docs/mcp)।

## पहली कॉल से पहले

1. अपनी [API key](https://zylalabs.com/hi/docs/api-keys) लें।
2. [कैटलॉग](https://zylalabs.com/hi/api-marketplace) में API खोलें और किसी plan को subscribe करें (या, अगर उसमें free trial है, तो उसे शुरू करें)। जिस API को आपने subscribe नहीं किया है, उसकी कॉल्स को `401` मिलता है।

## URL फॉर्मेट

```text
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)

```bash
curl 'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}?email=john@example.com' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```javascript
const res = await fetch(
  'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}?email=john@example.com',
  { headers: { Authorization: `Bearer ${process.env.ZYLA_API_KEY}` } }
);
const data = await res.json();
```

```python
import os, requests

r = requests.get(
    "https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}",
    params={"email": "john@example.com"},
    headers={"Authorization": f"Bearer {os.environ['ZYLA_API_KEY']}"},
)
print(r.status_code, r.json())
```

## JSON body (POST)

endpoint पर दिखाया गया method इस्तेमाल करें। किसी दूसरे method पर `401` के साथ `Invalid method` मिलता है।

```bash
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), देखें [प्लान, लिमिट और एरर](https://zylalabs.com/hi/docs/plans-and-limits)।


---
Source: https://zylalabs.com/hi/docs/calling-apis