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

# الحصول على قائمة واجهات API لمنصة AceDataCloud

> Platform API guide - Ace Data Cloud

يعيد بشكل مقسم إلى صفحات نقاط نهاية API المرئية في الموقع الحالي. مناسب للعثور على واجهات API حسب مسار العمل أو الخدمة أو مرحلة الإصدار؛ إذا كنت تحتاج فقط إلى التعريف الكامل لواجهة API واحدة، فيرجى استدعاء [تفاصيل API](https://platform.acedata.cloud/documents/platform-api-detail) مباشرةً.

## نظرة عامة على الواجهة

| العنصر | المحتوى |
| - | - |
| الطريقة | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/apis/` |
| المصادقة | عامة، لا تتطلب رمز حساب |
| التقسيم إلى صفحات | `count` + `items` |

## معلمات الاستعلام

| المعلمة | النوع | مطلوبة | الوصف |
| - | - | - | - |
| `path` | string | لا | مطابقة تامة لـ `path` أو `path2` |
| `service` | string | لا | الاسم المستعار للخدمة أو UUID |
| `stage` | string | لا | التصفية حسب مرحلة الإصدار؛ يمكن تمرير قيم متعددة بشكل متكرر |
| `limit` | integer | لا | عدد العناصر في كل صفحة، الحد الأقصى 100 |
| `offset` | integer | لا | إزاحة التقسيم إلى صفحات |

لا تُعد `id` و`service_id` و`tag` حاليًا معلمات تصفية للقائمة؛ ولن يؤدي تمريرها إلى تأثير التصفية المقابل.

```shell theme={null}
curl --get 'https://platform.acedata.cloud/api/v1/apis/' \
  --data-urlencode 'service=midjourney' \
  --data-urlencode 'stage=Production' \
  --data-urlencode 'limit=20' \
  -H 'Accept: application/json'
```

```python theme={null}
import requests

response = requests.get(
    "https://platform.acedata.cloud/api/v1/apis/",
    params={"service": "midjourney", "limit": 20},
    timeout=30,
)
response.raise_for_status()
for api in response.json()["items"]:
    print(api["id"], api["method"], api["path"])
```

## وصف الاستجابة

تستخدم الاستجابة الفعلية `{count, items}`. يتضمن كل عنصر في القائمة حاليًا حقول نموذج API، بالإضافة إلى:

* `document_id`: معرّف وثيقة المطور المرتبطة، وقد يكون فارغًا؛
* `service_id` / `service`: معرّف الخدمة الرئيسية وملخصها، وقد يكونان فارغين؛
* `definition`: تعريف OpenAPI، وقد يكون كبيرًا؛
* `method` و`path` و`path2` و`stage` و`cost` و`tags` و`metadata` وغيرها.

يتضمن serializer الخاص بالقائمة حاليًا `definition`، ويجب استخدام التقسيم إلى صفحات وتعيين مهلة عند جلب الكتالوج الكامل. قد تتم إضافة الحقول بتوافق مع الإصدارات السابقة، وعلى العميل قراءة الحقول المطلوبة فقط.

## الخطوة التالية

* [الحصول على تفاصيل API](https://platform.acedata.cloud/documents/platform-api-detail)
* [الحصول على قائمة الخدمات](https://platform.acedata.cloud/documents/platform-service-list)
* [الحصول على واجهات API التابعة للخدمة](https://platform.acedata.cloud/documents/platform-service-apis)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.