# توثیق اور حدود

API کلید [انٹیگریشنز (Integrations)](https://dash.bitsby.app/integrations/list) سیکشن میں حاصل کریں۔

## صلاحیتیں

* **انوائسز کا انتظام:** بنانا، منسوخ کرنا، اسٹیٹس جانچنا
* **ادائیگیوں کا انتظام:** ادائیگیوں کی فہرست، ادائیگی کو انوائس سے منسلک کرنا
* **اعداد و شمار:** پروجیکٹ، مدت، والٹ وغیرہ کے لحاظ سے مجموعی ڈیٹا
* **بلنگ:** پروجیکٹس کی فیس کی شرحیں، بیلنس

## حدود

* **درخواستوں کی رفتار:** فی کلید زیادہ سے زیادہ ایک درخواست فی سیکنڈ
* **کلیدوں کی تعداد:** فی اکاؤنٹ 10

## درخواستوں کی اجازت

ہر API درخواست کی اجازت کے لیے اپنی API کلید `Authorization` ہیڈر میں بھیجیں۔

API درخواست میں `Authorization` ہیڈر کی مثال:

```bash
curl -X POST https://api.bitsby.app/invoices/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay"
```

## سرور کا جواب

API سرور ہمیشہ JSON میں جواب دیتا ہے۔ درخواست کامیاب ہوئی یا نہیں، یہ جاننے کے لیے `result` پیرامیٹر استعمال کریں۔

کامیاب درخواست کے جواب کی مثال:

```json
{
    "result": "success",
    "data": .....
}
```

غلطی کی صورت میں جواب کی مثال:

```json
{
    "result": "error",
    "data": "Requests too frequent"
}
```