دسترسیها
سازمان شما زیرمجموعهای از قابلیته ای زربان سازمانی را دارد، نه همه آنها. این زیرمجموعه هنگام جذب سازمان تعیین میشود و در توکن شما قرار میگیرد. اگر مسیری را صدا بزنید که دسترسیاش را ندارید، پاسخ 403 است — حتی اگر توکن کاملاً معتبر باشد.
دسترسیها همان چیزیاند که در گفتوگوی نخست با زربان دربارهشان تصمیم میگیرید: «کدام محصولات برای شما فعال شود». به همین دلیل ساختار این مستندات هم بر همان اساس است — صفحه هر محصول با نام دسترسی لازمش شروع میشود.
شش دسترسی
| کد | برچسب | چه چیزی را باز میکند |
|---|---|---|
CoinDepositScope | واریز کوین | آدرس واریز، رصد واریز، رویدادهای واریز |
CoinWithdrawalScope | برداشت کوین | برداشت روی زنجیره، صف برداشت، لغو برداشت |
InternalTransferScope | انتقال داخلی | انتقال میان دو حساب همان سازمان، بدون تراکنش زنجیرهای |
LoanScope | وام | وام با وثیقه رمزارز |
SavingScope | سپردهگذاری | سپردهگذاری در استخر وامدهی |
DebtPositionScope | موقعیت بدهی | موقعیت وثیقه و گواهی قابل اشتراک |
دسترسیهای سازمان خود را ببینید
curl -sS "https://hd.zarban.io/tenants/PLN" \
-H "Authorization: Bearer $ZARBAN_TOKEN"
در پاسخ، آرایه scopes همان فهرست دسترسیهای فعال شماست:
{
"id": "PLN",
"name": "…",
"scopes": ["CoinDepositScope", "CoinWithdrawalScope", "LoanScope"]
}
چه چیزی پشت دسترسی نیست
اینها همیشه در دسترساند، صرفنظر از اینکه سازمان شما چه دسترسیهایی دارد:
- حسابها — پایه همه چیز است؛ بدون حساب هیچ محصولی معنا ندارد.
- موجودی
- وبهوکها — البته رویدادهایی که واقعاً دریافت میکنید به دسترسیهای شما بستگی دارد.
- گزارشها و تحلیلها، لاگ ممیزی، هشدارها
برخورد درست با 403
403 را بهعنوان خطای گذرا در نظر نگیرید و دوباره تلاش نکنید. دسترسیها پیکربندی سازماناند و بین دو درخواست تغییر نمیکنند؛ تلاش مجدد فقط لاگ شما را شلوغ میکند.
اگر مطمئنید محصولی باید برای شما فعال باشد اما 403 میگیرید، اول با فراخوانی بالا فهرست scopes را ببینید و سپس با تماس سازمانی خود در زربان پیگیری کنید. شما نمیتوانید دسترسی ها را از راه API تغییر دهید.
در طراحی سرویستان، بهتر است فهرست دسترسیها را یک بار در زمان راهاندازی بخوانید و قابلیتهای مربوطه را در محصول خودتان خاموش یا روشن کنید — بهجای اینکه به کاربر دکمهای نشان دهید که فشردنش به 403 میرسد.