پرش به محتوا

API و یکپارچه‌سازی

API یک الحاقیهٔ بعدی نیست

مسیرهای نسخه‌دار، توکن هر دستگاه، همان قواعد مجوزدهی.

  • یک پیشوند نسخه‌دار

    قرارداد عمومی ثابت است: تغییرات افزایشی‌اند و هر تغییر شکننده نسخهٔ جدید می‌خواهد. یک نام مستعار قدیمی فقط برای دورهٔ گذار وجود دارد.

  • شمای منتشرشده

    یک سند OpenAPI مرجع، همهٔ مسیرها را توصیف می‌کند تا کلاینت‌ها تولید شوند نه دستی نوشته.

  • جفت توکن برای هر دستگاه

    اعتبارنامه به جفت توکن دسترسی و تازه‌سازی تبدیل می‌شود؛ یک سطر برای هر دستگاه، هش‌شده و مستقلاً قابل ابطال.

قرارداد

یکپارچه‌سازی در عمل یعنی چه

  • یک پیشوند نسخه‌دار

    قرارداد عمومی ثابت است: تغییرات افزایشی‌اند و هر تغییر شکننده نسخهٔ جدید می‌خواهد. یک نام مستعار قدیمی فقط برای دورهٔ گذار وجود دارد.

  • شمای منتشرشده

    یک سند OpenAPI مرجع، همهٔ مسیرها را توصیف می‌کند تا کلاینت‌ها تولید شوند نه دستی نوشته.

  • جفت توکن برای هر دستگاه

    اعتبارنامه به جفت توکن دسترسی و تازه‌سازی تبدیل می‌شود؛ یک سطر برای هر دستگاه، هش‌شده و مستقلاً قابل ابطال.

  • همان مجوزدهی

    توکن‌ها از همان مسیر کدی می‌گذرند که نشست مرورگر؛ پس همهٔ قواعد تفکیک و نقش بدون تغییر اعمال می‌شوند.

  • پوشش خطای پایدار

    هر خطا یک شرح انسانی و یک کد ماشینی پایدار دارد؛ خطاهای اعتبارسنجی یک نگاشت مسطح از فیلدها اضافه می‌کنند.

  • محدودیت نرخ آنجا که لازم است

    نقاط ورود اعتبارنامه محدودیت نرخ دارند و پاسخ خطا عمداً یکنواخت است.

تیم‌ها با آن چه می‌سازند

یکپارچه‌سازی‌های رایج

  • ارسال ماهانهٔ عملکرد از ERP یا خروجی دفتر کل به یک اسپرد
  • خواندن متن تأییدشدهٔ اسناد به انبار داده
  • همگام‌سازی دفترچهٔ مشتریان با CRM موجود به‌عنوان سامانهٔ مرجع
  • تغذیهٔ ارقام پایپ‌لاین به داشبورد سازمانی
  • بارگذاری انبوه اتاق داده در ابتدای یک بررسی موشکافانه
  • خروجی گرفتن اسپردها و جدول‌ها در قالب گزارش‌گیری خود مشتری

آنچه وجود ندارد

هنوز وب‌هوک خروجی نداریم و کانکتور آماده برای محصولات حسابداری یا CRM خاص هم نداریم. یکپارچه‌سازی امروز روی REST API انجام می‌شود که پایدار و مستند است — اما اگر به مدل ارسال (push) نیاز دارید نه دریافت (poll)، در مرحلهٔ ارزیابی بگویید.

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

دربارهٔ API

  • API در همهٔ طرح‌ها هست؟
    بله. همان APIای است که خود رابط محصول استفاده می‌کند و دسترسی، تابع مجوزهای حسابی است که توکنش را به کار می‌برید.
  • دسترسی کارمندی که می‌رود را چطور قطع کنیم؟
    حساب را غیرفعال کنید: نشست‌های زنده بلافاصله تمام می‌شوند و توکن‌های دستگاهش دیگر معتبر نیستند. توکن هر دستگاه را هم می‌شود جداگانه باطل کرد.

دربارهٔ استقرار خودتان با ما گفت‌وگو کنید

پرسش‌نامهٔ امنیتی، محدودیت‌های شبکه و زمان‌بندی‌تان را بیاورید. ترجیح می‌دهیم به سؤال‌های سخت پیش از آزمایش پاسخ دهیم، نه بعد از آن.