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

> ثلاث نقاط وصول، تُستدعى من خادمك بمفتاحك السري.

هذه صفحة واحدة من توثيق Antiro (https://docs.antiro.io/ar/api). كل الصفحات في ملف واحد: https://docs.antiro.io/ar/llms-full.txt

## العنوان الأساسي

تُرسل كل الطلبات إلى `https://api.antiro.io`.

## المصادقة

أرسل [مفتاحك السري](https://docs.antiro.io/ar/api-keys) في الرأس `X-API-Key` مع كل طلب، واستدعِ الواجهة من خادمك فقط.

**طلب مع المصادقة**

```bash
curl https://api.antiro.io/v1/assessments/<id> \
  -H "X-API-Key: $ANTIRO_SECRET_KEY"
```

## نقاط الوصول

| الطريقة | المسار | ما تفعله |
| --- | --- | --- |
| `POST` | [`/v1/assessments`](https://docs.antiro.io/ar/api/assessments) | فحص الطلب |
| `GET` | [`/v1/assessments/:id`](https://docs.antiro.io/ar/api/assessments#%D9%82%D8%B1%D8%A7%D8%A1%D8%A9-%D9%81%D8%AD%D8%B5-%D8%B3%D8%A7%D8%A8%D9%82) | قراءة فحص سابق |
| `POST` | [`/v1/outcomes`](https://docs.antiro.io/ar/api/outcomes) | إبلاغ ما وجده فريقك |

## الطلبات

أرسل JSON مع `Content-Type: application/json`. يتجاهل Antiro الحقول التي لا يعرفها، والنص الأطول من حد الحقل يُقصّ ولا يُرفض: انظر [حدود الحقول](https://docs.antiro.io/ar/api/errors#%D8%AD%D8%AF%D9%88%D8%AF-%D8%A7%D9%84%D8%AD%D9%82%D9%88%D9%84).

## الأجوبة

كل جواب بصيغة JSON. يعيد `POST` الناجح الرمز `201`، ويعيد `GET` الناجح الرمز `200`. وللأخطاء [صيغة واحدة](https://docs.antiro.io/ar/api/errors#%D8%B5%D9%8A%D8%BA%D8%A9-%D8%A7%D9%84%D8%AE%D8%B7%D8%A3).