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

# أنشئ تطبيق اختبار REST باستخدام Node

> استخدم عينة البدء السريع لـ Node كدليل للتكامل المباشر عبر HTTP وسكربت اختبار أولي.

استخدم هذه الصفحة إذا أردت أصغر تكامل ممكن باستخدام Node ورؤية كل طلب HTTP بوضوح.

**الهدف:** تحقّق من صحة Phaseo واكتشاف النماذج وطلب إنشاء واحد باستخدام HTTP مباشر.

**النتيجة:** سكربت قليل الاعتماديات يمكنك الاحتفاظ به لاختبار النشر أو التكامل.

<Prompt description="أنشئ **تطبيق اختبار REST باستخدام Node** لـ Phaseo عبر HTTP مباشر." icon="terminal" actions={["copy", "cursor"]}>
  {`أنت بصدد إنشاء تكامل صغير باستخدام Node.js مع Phaseo Gateway عبر HTTP مباشر.

    أنشئ تطبيقًا يعتمد على سكربت ويقوم بما يلي:
    - يقرأ PHASEO_API_KEY من البيئة
    - يستدعي مسارات الصحة واكتشاف النماذج
    - يرسل طلب إنشاء نص واحدًا
    - يستدعي اختياريًا واجهة إضافية مثل embeddings

    المتطلبات:
    - استخدم fetch مباشرةً، وليس SDK.
    - اجعل اعتماديات الشيفرة قليلة.
    - اجعل محتوى الطلبات واضحًا وسهل التدقيق.
    - اطبع رسائل نجاح وأخطاء واضحة في الطرفية.
    - ادعم وضع اختبار أولي سريعًا ووضعًا أشمل من البداية إلى النهاية.

    المخرجات:
    - السكربت
    - أوامر package.json
    - README موجز
    - إدخال في .env.example

    التحقق:
    - شغّل وضع الاختبار الأولي إن أمكن
    - نفّذ مسار طلب كاملًا إن أمكن
    - أبلغ عمّا تم التحقق منه وأي افتراضات متبقية.`}
</Prompt>

## المشروع النموذجي

* GitHub: [examples/gateway-node-quickstart](https://github.com/phaseoteam/Phaseo/tree/main/examples/gateway-node-quickstart)
* مسار المشروع داخل المستودع: `examples/gateway-node-quickstart`

## ما يفعله التطبيق

* يستدعي `GET /v1/health`
* يستدعي `GET /v1/models`
* يختبر مسارات الإنشاء مثل `POST /v1/responses`
* يوفر مرجعًا لاستخدام HTTP مباشر في الاختبارات الأولية والسكربتات وفحوصات الواجهة الخلفية

## متى يكون هذا المثال مناسبًا

ابدأ من هنا عندما:

* تريد تصحيح استدعاءات API مباشرةً
* لا تريد طبقات تجريد SDK بعد
* تبني سكربتًا أو عاملًا أو CLI بدلًا من واجهة ويب

## المتطلبات المسبقة

* Node.js مع دعم `fetch` support
* مفتاح Phaseo API

## تشغيل المثال

```bash theme={null}
cd examples/gateway-node-quickstart
cp .env.example .env.local
```

عيّن:

* `PHASEO_API_KEY`

ثم شغّل أحد الأمرين:

```bash theme={null}
npm run smoke
```

أو:

```bash theme={null}
npm run start
```

## تحقق من النتيجة

* يؤكد وضع الاختبار الأولي إمكانية الوصول إلى API.
* يعيد اكتشاف النماذج نموذجًا واحدًا على الأقل.
* تطبع العملية الكاملة رد إنشاء ناجحًا واحدًا.
* تعرض أخطاء المصادقة والردود غير 200 أخطاء واضحة في الطرفية.

## ما الذي يجب مراجعته في الشيفرة

* كيف يحمّل السكربت `.env.local`
* كيفية إضافة ترويسة التفويض
* كيفية إنشاء كل طلب بوضوح
* كيفية إظهار الردود غير 200 بدلًا من تجاهلها

## كيفية تخصيص المثال

* اختصر السكربت ليقتصر على المسارات التي تحتاجها خدمتك
* انقل شيفرة الطلبات المشتركة إلى helper إذا كانت عدة سكربتات ستستخدمها
* انتقل لاحقًا إلى TypeScript SDK إذا تكرر مسار HTTP المباشر

## أدلة ذات صلة

* [مطالبات بدء تطبيق صغير](./mini-app-starter-prompts.mdx)
* [ابدأ باستخدام الموجّه المجاني](./free-router-first-deploy.mdx)
* [الأمثلة](../guides/examples.mdx)


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