> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.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
{alt}
; }; سيساعدك هذا الدليل في اختبار واجهة برمجة تطبيقات 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، مما يسهّل اختبار واجهات برمجة التطبيقات.
#### عيّن معرّف المؤسسة ومعرّف الخدمة
* ضمن "Collection"، انقر على علامة التبويب "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 من دون معلومات عن الخدمات، فهذا يعني أن إعدادك غير صحيح).