مرجع API
همهٔ مسیرهای API دانا با بدنهٔ درخواست، پاسخ و خطاها
API دانا روی https://api.dana.expert است و با یک کلید کار می‌کند. هر مسیر در این بخش یک صفحه دارد: فیلدهای درخواست، ساختار پاسخ، نمونهٔ کد و خطاهایی که ممکن است برگردد.
آدرس پایه
https://api.dana.expertاحراز هویت
کلید را در هدر Authorization بفرستید:
Authorization: Bearer dn-live-...کلاینت‌های Anthropic همان کلید را با x-api-key هم می‌توانند بفرستند. کلید را از کنسول دانا بسازید؛ جزئیات در حساب و کلید API است.
مسیرها
| مسیر | کار | وضعیت |
|---|---|---|
POST /v1/translate | ترجمهٔ انگلیسی به فارسی با هدهد | در دسترس |
POST /v1/decide | تصمیم‌های بسته روی متن فارسی با سنجه | در دسترس |
GET /v1/models | فهرست مدل‌ها و نسخهٔ هر کدام | در دسترس |
POST /v1/chat/completions | گفت‌وگو با هما، رابط OpenAI | در دسترس |
POST /v1/messages | گفت‌وگو با هما، رابط Anthropic | در دسترس |
POST /v1/messages/count_tokens | شمارش توکن پیش از ارسال | در دسترس |
پاسخ‌ها و خطاها
پاسخ موفق JSON است و 200 برمی‌گردد. خطاها هم JSONاند و فرمت ثابتی دارند:
{"error": {"message": "Invalid API key.", "type": "authentication_error", "param": null, "code": null}}مسیرهای /v1/messages فرمت Anthropic را برمی‌گردانند: {"type": "error", "error": {"type": "...", "message": "..."}}. فهرست کامل کدها و راه‌حل هرکدام در خطاها است و سقف درخواست‌ها در محدودیت‌ها.
برای ابزارهای هوش مصنوعی
هر صفحه نسخهٔ Markdown دارد: کافی است به آخر آدرس صفحه .md اضافه کنید، مثل /docs/api-reference/translate.md. دکمهٔ «کپی صفحه» بالای هر صفحه همین متن را کپی می‌کند. فهرست همهٔ صفحه‌ها در /llms.txt و متن کامل مستندات در یک فایل در /llms-full.txt است.