> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على Gorelo API

> استخدم Gorelo API لدمج المنتجات الخارجية مع تطبيقاتك، عبر مصادقة مفتاح API بترويسة X-API-Key، وصلاحيات محددة النطاق، ومعالجة أخطاء HTTP القياسية.

يتيح لك Gorelo التكامل مع أي منتج خارجي عبر Gorelo API.

يستخدم Gorelo API مفاتيح API. أدرج مفتاحك في كل طلب عبر ترويسة X-API-Key.

يعتمد عنوان URL الأساسي لـ Gorelo على المنطقة التي اخترت استضافة بياناتك عليها في Gorelo:

<Tabs>
  <Tab title="US">
    Base URL: [**https://api.usw.gorelo.io/**](https://api.usw.gorelo.io/)\
    API Reference: [**https://api.usw.gorelo.io/swagger**](https://api.usw.gorelo.io/swagger)
  </Tab>

  <Tab title="Australia">
    Base URL: [**https://api.aue.gorelo.io/**](https://api.aue.gorelo.io/)\
    API Reference: [**https://api.aue.gorelo.io/swagger**](https://api.aue.gorelo.io/swagger)
  </Tab>
</Tabs>

## النطاقات والصلاحيات

يمكن أن تكون مفاتيح API **محددة النطاق**. إذا كان المفتاح يفتقر إلى الوصول لنقطة نهاية معينة، تُرجع واجهة API الخطأ **403 Forbidden**.

## معالجة الأخطاء

| الخطأ                     | المعنى                    |
| :------------------------ | :------------------------ |
| **401 Unauthorized**      | مفتاح API مفقود/غير صالح  |
| **403 Forbidden**         | مفتاح صالح، نطاق غير كافٍ |
| **429 Too Many Requests** | تم تجاوز حد المعدّل       |

## معرّفات الحالات

## الأصول الوكيلة

| ID | الحالة                |
| :- | :-------------------- |
| 1  | Installing            |
| 2  | Online                |
| 3  | Offline               |
| 4  | Pending Delete        |
| 5  | Deleted               |
| 6  | Pending Client Delete |
| 7  | Client Deleted        |