# مرجع API

> همهٔ مسیرهای API دانا با بدنهٔ درخواست، پاسخ و خطاها

URL: https://dana.expert/docs/api-reference

API دانا روی `https://api.dana.expert` است و با یک کلید کار می‌کند. هر مسیر در این بخش یک صفحه دارد: فیلدهای درخواست، ساختار پاسخ، نمونهٔ کد و خطاهایی که ممکن است برگردد.

## آدرس پایه

```
https://api.dana.expert
```

## احراز هویت

کلید را در هدر `Authorization` بفرستید:

```
Authorization: Bearer dn-live-...
```

کلاینت‌های Anthropic همان کلید را با `x-api-key` هم می‌توانند بفرستند. کلید را از [کنسول دانا](https://console.dana.expert/keys) بسازید؛ جزئیات در [حساب و کلید API](https://dana.expert/docs/authentication) است.

## مسیرها

| مسیر | کار | وضعیت |
|---|---|---|
| [`POST /v1/translate`](https://dana.expert/docs/api-reference/translate) | ترجمهٔ انگلیسی به فارسی با هدهد | در دسترس |
| [`POST /v1/decide`](https://dana.expert/docs/api-reference/decide) | تصمیم‌های بسته روی متن فارسی با سنجه | در دسترس |
| [`GET /v1/models`](https://dana.expert/docs/api-reference/list-models) | فهرست مدل‌ها و نسخهٔ هر کدام | در دسترس |
| [`POST /v1/chat/completions`](https://dana.expert/docs/api-reference/chat-completions) | گفت‌وگو با هما، رابط OpenAI | در دسترس |
| [`POST /v1/messages`](https://dana.expert/docs/api-reference/messages) | گفت‌وگو با هما، رابط Anthropic | در دسترس |
| [`POST /v1/messages/count_tokens`](https://dana.expert/docs/api-reference/count-tokens) | شمارش توکن پیش از ارسال | در دسترس |

## پاسخ‌ها و خطاها

پاسخ موفق JSON است و `200` برمی‌گردد. خطاها هم JSON‌اند و فرمت ثابتی دارند:

```json
{"error": {"message": "Invalid API key.", "type": "authentication_error", "param": null, "code": null}}
```

مسیرهای `/v1/messages` فرمت Anthropic را برمی‌گردانند: `{"type": "error", "error": {"type": "...", "message": "..."}}`. فهرست کامل کدها و راه‌حل هرکدام در [خطاها](https://dana.expert/docs/errors) است و سقف درخواست‌ها در [محدودیت‌ها](https://dana.expert/docs/rate-limits).

## برای ابزارهای هوش مصنوعی

هر صفحه نسخهٔ Markdown دارد: کافی است به آخر آدرس صفحه `.md` اضافه کنید، مثل [`/docs/api-reference/translate.md`](https://dana.expert/docs/api-reference/translate.md). دکمهٔ «کپی صفحه» بالای هر صفحه همین متن را کپی می‌کند. فهرست همهٔ صفحه‌ها در [`/llms.txt`](https://dana.expert/llms.txt) و متن کامل مستندات در یک فایل در [`/llms-full.txt`](https://dana.expert/llms-full.txt) است.