> ## Documentation Index
> Fetch the complete documentation index at: https://resq-dependabot-github-actions-github-actions-478e18be3d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# بدء سريع
> أجرِ أول استدعاء مُصادَق على واجهات برمجة ResQ Tactical OS في خمس دقائق.
يكشف ResQ واجهتي API عبر HTTPS:
| API | عنوان URL الأساسي | البِنية التقنية |
| ------------------ | ------------------------------------ | ------------------- |
| Infrastructure API | `https://api.resq.software` | Rust + Axum |
| Coordination API | `https://coordination.resq.software` | TypeScript + Elysia |
إذا كنت تشغّل نشرًا ذاتي الاستضافة، استبدل عناوين URL الأساسية أعلاه
بعناوينك. أشكال الطلبات متطابقة.
## الخطوات
استدعِ `/health` على Infrastructure API. لا يتطلب مصادقة.
```bash curl theme={null}
curl https://api.resq.software/health
```
```ts TypeScript theme={null}
const res = await fetch("https://api.resq.software/health");
console.log(await res.json());
```
```python Python theme={null}
import httpx
print(httpx.get("https://api.resq.software/health").json())
```
تبدو الاستجابة السليمة هكذا:
```json theme={null}
{
"status": "ok",
"pinata": true,
"gemini": true,
"spoon_os": "0.1.0"
}
```
يستخدم Infrastructure API توكنات JWT من نوع bearer. استبدل بيانات
الاعتماد بتوكن على `POST /login`.
```bash curl theme={null}
curl -X POST https://api.resq.software/login \
-H "Content-Type: application/json" \
-d '{"username":"اسم-المستخدم-الخاص-بك","password":"كلمة-المرور-الخاصة-بك"}'
```
```ts TypeScript theme={null}
const res = await fetch("https://api.resq.software/login", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ username, password }),
});
const { token, expires_at } = await res.json();
```
تحمل الاستجابة توكنًا وطابع وقت Unix لانتهاء الصلاحية:
```json theme={null}
{
"token": "eyJhbGciOi...",
"expires_at": 1746345600
}
```
احفظ التوكن بأمان. للحصول على إرشادات التحديث والتدوير راجع
[المصادقة](/ar/authentication).
أرسل التوكن كرأس `Bearer`.
```bash curl theme={null}
curl https://api.resq.software/evidence \
-H "Authorization: Bearer $RESQ_TOKEN"
```
```ts TypeScript theme={null}
const res = await fetch("https://api.resq.software/evidence", {
headers: { Authorization: `Bearer ${token}` },
});
```
يكشف Coordination API مقاييس Prometheus وأحداث Server-Sent Events
لحالة الأسطول في الوقت الفعلي.
```bash theme={null}
curl -N https://coordination.resq.software/events
```
كل سطر هو حدث JSON: إطارات قياس عن بُعد، تغيّرات حالة المهمة، وموافقات
HITL.
تجنّب كتابة عميل — ثبّت أحد SDKs الرسمية بدلاً من ذلك.
`@resq-sw/http`، `@resq-sw/security`، مكوّنات UI.
`resq-mcp` (خادم FastMCP) و `resq-dsa`.
`resq` CLI الموحَّد بالإضافة إلى سبع أدوات TUI.
عملاء بأنواع، عقود Protobuf، أُطُر محاكاة.
## التالي
دورة حياة JWT والتدوير.
غلاف الأخطاء ورموز الحالة.
كل نقاط النهاية والطلبات والاستجابات.