صفحه کجاست
در منوی کناری: اتصال و سامانه ← کلیدهای API.

- ۱کادر «راهنمای کلید API»
- ۲«ساخت کلید»
- ۳«نام» — نامی که هنگام ساخت دادهاید
- ۴«کلید» — فقط ابتدای کلید، مثل
qzk_abcd_…؛ برای شناختن کلید، نه استفاده - ۵«دسترسیها»
- ۶«آخرین استفاده» — یا «استفاده نشده»
- ۷«وضعیت» — «فعال» یا «ابطالشده»؛ در ستون «عملیات»، «ابطال»
- ۸«نحوهٔ استفاده» — نشانیهای قابل استفاده با نمونهٔ درخواست
- ۹محدودیتها: ۱۲۰ درخواست در دقیقه برای هر کلید، فهرستها صفحهبندیشده
ساختن کلید

- ۱«نام کلید» — برای شناختن کلید، مثلاً «نرمافزار انبار»
- ۲«خواندن منو» — دستهها، آیتمها، قیمت و موجودی
- ۳«خواندن سفارشها» — سفارشها با اقلام و مبالغ
- ۴«خواندن مشتریان» — نام، شمارهٔ همراه و ایمیل مشتریان؛ فقط برای نرمافزاری که به آن اطمینان دارید
- ۵«تغییر موجود بودن آیتم» — ناموجود یا موجود کردن آیتم؛ منوی باز مشتریان همان لحظه بهروز میشود
- ۶«ساخت کلید»
- ۷«انصراف»
پس از ساخت، پنجرهٔ «کلید «…» ساخته شد» کلید کامل را نشان میدهد. با «رونوشت کلید» آن را بردارید و جای امن نگه دارید. پس از «بستن» دیگر نمایش داده نمیشود؛ اگر گم شد، کلید تازه بسازید و قبلی را ابطال کنید.
استفاده از کلید
کلید در سرایند Authorization فرستاده میشود. خود کلید مجموعه را مشخص میکند و همهٔ مبلغها به ریال است.
| نشانی | دسترسی لازم | کار |
|---|---|---|
GET /tenant-api/v1/menu | «خواندن منو» | منو |
GET /tenant-api/v1/orders | «خواندن سفارشها» | سفارشها؛ با from و page |
GET /tenant-api/v1/customers | «خواندن مشتریان» | مشتریان؛ با page و pageSize (حداکثر ۱۰۰) |
PATCH /tenant-api/v1/menu-items/{id}/availability | «تغییر موجود بودن آیتم» | بدنه: {"isAvailable": false} |
نشانی کامل سرور در کادر «نحوهٔ استفاده» همین صفحه آمده است. کلیدی که دسترسی لازم را نداشته باشد، درخواست را رد شده میگیرد.
ابطال
«ابطال» فوری است و برگشت ندارد: نرمافزاری که از کلید استفاده میکند همان لحظه دسترسیاش را از دست میدهد. کلید ابطالشده با وضعیت «ابطالشده» در فهرست میماند تا بدانید چه کلیدی بوده است. کلیدی را که لو رفته، یا نرمافزارش دیگر استفاده نمیشود، ابطال کنید.
دسترسی و پلن
صفحه در پلن تجاری و زنجیرهای است، و در پلن حرفهای با افزودنی «API و Webhook». در پلن دیگر، صفحه کارت «API در پلن تجاری» و دکمهٔ «مشاهدهٔ پلنها» را نشان میدهد.
| کار | نقشها |
|---|---|
| دیدن، ساختن و ابطال کلید | فقط مالک |
مطالب مرتبط
نقشها: مالک
همهٔ مقالههای این بخش