همه صفحه‌ها

احراز هویت

همهٔ اندپوینت‌های /v1/* با یک کلید Bearer احراز هویت می‌شوند: هدر Authorization: Bearer ng-... را به هر درخواست اضافه کنید. کلید مثل رمز عبور است. آن را در کد سمت کاربر یا مخزن عمومی قرار ندهید. برای تکرار امن درخواست‌های POST می‌توانید هدر اختیاری Idempotency-Key هم بفرستید.

Your Hormouz API key. Include it in every request:

Authorization: Bearer ng-1234567890abcdef1234567890abcdef

The key is shown once when your admin creates your account. If lost, ask your admin to reset it.

سوالات متداول

اگر کلید API لو رفت چه کنم؟

فوراً از مدیر حساب بخواهید کلید را ریست کند. کلید قدیمی بلافاصله باطل می‌شود و کلید جدید یک بار نمایش داده می‌شود.

درخواست بدون کلید چه پاسخی می‌گیرد؟

401 UNAUTHORIZED با ساختار خطای استاندارد {"error":{"code":"UNAUTHORIZED",...}}.

به‌روزرسانی: 2026-10-13