احراز هویت
credential فقط برای درخواست‌های server-to-server و بر اساس visibility لازم است.
Header درخواست
توکن سرویس را هرگز در مرورگر یا فایل عمومی قرار ندهید.
HTTP header
Authorization: Bearer <service-token>Scopeها
| Scope | دسترسی |
|---|---|
knowledge:read:internal | PUBLIC و INTERNAL |
knowledge:read:management | PUBLIC، INTERNAL و MANAGEMENT |
knowledge:read:restricted | همهٔ visibilityها |
knowledge:read:all | scope گسترده؛ برای integration معمولی توصیه نمی‌شود. |
برای API عمومی از Try it استفاده کنید. endpointهای محافظت‌شده را از backend خود فراخوانی کنید و توکن را در localStorage، sessionStorage، cookie، URL، analytics یا console ذخیره نکنید.
رفتار بدون credential
در collectionهای عمومی، رکوردهای private حذف می‌شوند. درخواست مستقیم به شناسهٔ private برای caller غیرمجاز با 404 fail closed می‌شود تا وجود رکورد آشکار نشود.