> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # الوصول البرمجي إلى واجهة برمجة تطبيقات باستخدام Postman > سيساعدك هذا الدليل على اختبار واجهة برمجة تطبيقات ClickHouse Cloud باستخدام Postman export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return

; }; سيساعدك هذا الدليل في اختبار واجهة برمجة تطبيقات ClickHouse Cloud باستخدام [Postman](https://www.postman.com/product/what-is-postman/). يتوفر تطبيق Postman للاستخدام عبر متصفح الويب، أو يمكن تنزيله على جهاز سطح المكتب.

### أنشئ حسابًا

* تتوفر حسابات مجانية على [https://www.postman.com](https://www.postman.com). موقع Postman

### أنشئ مساحة عمل

* سمِّ مساحة العمل وحدِّد مستوى الظهور. إنشاء مساحة عمل

### إنشاء مجموعة

* أسفل "Explore" في القائمة أعلى اليسار، انقر على "Import": Explore > Import

* ستظهر نافذة منبثقة: إدخال عنوان URL لواجهة برمجة التطبيقات

* أدخل عنوان واجهة برمجة التطبيقات: "[https://api.clickhouse.cloud/v1](https://api.clickhouse.cloud/v1)" ثم اضغط على 'Enter': * حدِّد "Postman Collection" بالنقر على زر "Import": Collection > Import

### التعامل مع مواصفة واجهة برمجة تطبيقات ClickHouse Cloud

* ستظهر الآن "مواصفة واجهة برمجة تطبيقات ClickHouse Cloud" ضمن "Collections" (شريط التنقل الأيسر). استيراد واجهة برمجة تطبيقاتك

* انقر على "مواصفة واجهة برمجة تطبيقات ClickHouse Cloud". ومن الجزء الأوسط، اختر علامة التبويب 'Authorization': اكتمل الاستيراد

### إعداد التفويض

* استخدم القائمة المنسدلة لتحديد "Basic Auth": المصادقة الأساسية

* أدخل اسم المستخدم وكلمة المرور اللذين تلقيتهما عند إعداد مفاتيح واجهة برمجة تطبيقات ClickHouse Cloud: بيانات الاعتماد

### تفعيل المتغيرات

* تتيح [المتغيرات](https://learning.postman.com/docs/sending-requests/variables/) تخزين القيم وإعادة استخدامها في Postman، مما يسهّل اختبار واجهات برمجة التطبيقات.

#### عيّن معرّف المؤسسة ومعرّف الخدمة

* ضمن "مجموعة"، انقر على علامة التبويب "Variable" في الجزء الأوسط (سيكون عنوان URL الأساسي قد تم تعيينه عبر استيراد واجهة برمجة التطبيقات السابق): * أسفل `baseURL`، انقر على الحقل الفارغ "Add new value"، ثم أدخِل معرّف المؤسسة ومعرّف الخدمة:

## اختبر وظائف واجهة برمجة تطبيقات ClickHouse Cloud

### اختبر "GET list of available organizations"

* ضمن "OpenAPI spec for ClickHouse Cloud"، وسّع المجلد > V1 > organizations * انقر على "GET list of available organizations" ثم اضغط الزر الأزرق "Send" على اليمين: اختبار استرجاع organizations

* ينبغي أن تعرض النتائج المُعادة تفاصيل مؤسستك الخاصة بك مع "status": 200. (إذا تلقيت "status" 400 من دون أي معلومات عن مؤسسة، فهذا يعني أن الإعداد غير صحيح). الحالة

### اختبار "GET organizational details"

* ضمن المجلد `organizationid`، انتقل إلى "GET organizational details": * في قائمة الإطار الأوسط ضمن Params، تكون قيمة `organizationid` مطلوبة. اختبار استرجاع تفاصيل المؤسسة

* عدّل هذه القيمة إلى `orgid` بين أقواس معقوفة `{{orgid}}` (بعد ضبط هذه القيمة مسبقًا، ستظهر قائمة تتضمن القيمة): إرسال الاختبار

* بعد الضغط على زر "Save"، اضغط على الزر الأزرق "Send" في أعلى يمين الشاشة. القيمة المُعادة

* يجب أن تعرض النتائج المُعادة تفاصيل مؤسستك مع "status": 200. (إذا تلقيت "status" 400 من دون أي معلومات عن المؤسسة، فهذا يعني أن الإعداد غير صحيح).

### اختبر "GET service details"

* انقر على "GET service details" * عدّل القيم الخاصة بـ `organizationid` و`serviceid` باستخدام `{{orgid}}` و`{{serviceid}}` على التوالي. * اضغط على "Save" ثم على الزر الأزرق "Send" الموجود على اليمين. قائمة الخدمات

* يجب أن تعرض النتائج المُعادة قائمة بخدماتك وتفاصيلها مع "status": 200. (إذا تلقيت "status" 400 من دون معلومات عن الخدمات، فهذا يعني أن إعدادك غير صحيح).