خروجی داده و API کارنوبت؛ اتصال رزروها به نرم‌افزارهای دیگر
ساخت کلید API با دسترسی محدود، محدودیت IP و تاریخ انقضا برای خواندن رزروها، مشتریان، خدمات و کارمندان؛ و نکات امنیتی اتصال به حسابداری یا CRM.
خلاصه در یک نگاه
- کلید API در «تنظیمات ← خروجی و API» ساخته میشود.
- هر کلید فقط به بخش‌هایی دسترسی دارد که انتخاب کرده‌اید.
- IPهای مجاز و تاریخ انقضا، ریسک نشت کلید را کم می‌کند.
- کلید فقط یک بار نمایش داده میشود؛ آن را امن نگه دارید.
ساخت کلید API
- ۱
نام‌گذاری
برای هر اتصال یک کلید جدا با نام مشخص (مثلاً «حسابداری») بسازید.
- ۲
انتخاب دسترسی
فقط بخش‌های لازم را فعال کنید.
- ۳
محدودیت IP
اگر سرور مقصد IP ثابت دارد، آن را در فهرست مجاز وارد کنید.
- ۴
تاریخ انقضا
برای اتصال‌های موقت تاریخ انقضا بگذارید.
| دسترسی | داده‌ها |
|---|---|
| bookings:read | نوبت‌ها با مشتری، خدمت، کارمند، وضعیت و مبلغ |
| customers:read | نام، شماره تماس، ایمیل، تعداد رزرو و آخرین مراجعه |
| services:read | نام خدمت، مدت، قیمت و پیش‌پرداخت |
| staff:read | نام، تخصص، امتیاز و وضعیت فعال بودن |
فراخوانی API
کلید را در سرآیند X-Api-Key یا به شکل Authorization: Bearer ارسال کنید. درخواست‌ها تعداد محدودی در دقیقه دارند؛ اگر پاسخ 429 گرفتید، طبق سرآیند Retry-After کمی صبر کنید.
خروجی گرفتن بدون برنامه‌نویسی
اگر فقط یک فایل از رزروها یا مشتریان لازم دارید، از خروجی‌های داخل پنل (مثلاً گزارش‌ها و فهرست رزروهای ناتمام) استفاده کنید؛ برای اتصال دائمی به نرم‌افزار دیگر API مناسب‌تر است.
پرسش‌های متداول
API امکان ثبت یا تغییر نوبت دارد؟
در حال حاضر API فقط خواندنی است و برای گزارشگیری و همگامسازی داده استفاده میشود.
API در همه پلن‌ها فعال است؟
دسترسی API به پلن بستگی دارد؛ اگر بخش آن در تنظیمات قفل است، پلن را ارتقا دهید.
نوبت‌دهی آنلاین را همین امروز شروع کنید
خدمات، کارمندان و ساعات کاری را وارد کنید و یک لینک ثابت برای رزرو آنلاین مشتریان داشته باشید؛ بدون هزینه راه‌اندازی اولیه.
راهنماهای مرتبط
امکانات پیشرفته
اتصال دامنه اختصاصی
صفحه رزرو کارنوبت را روی دامنه خودتان (مثل booking.brand.ir) بیاورید: ثبت دامنه در پنل، تنظیم رکورد CNAME یا A و رکورد TXT مالکیت، و رفع خطاهای رایج.
امکانات پیشرفته
مدیریت چند شعبه
تعریف شعبه‌ها با آدرس، تلفن، مدیر و ساعات کاری جدا، اختصاص خدمات و کارمندان به هر شعبه و دیدن رزروها و گزارش‌ها به تفکیک شعبه یا تجمیعی.
مدیریت نوبت‌ها
مدیریت رزروها و تقویم
ثبت رزرو تلفنی و حضوری، تأیید و لغو نوبت، جابه‌جایی در تقویم هفتگی، ثبت حضور یا عدم مراجعه و استفاده از اعلان‌ها برای مدیریت روزانه نوبت‌ها.