نسخه‌بندی ای‌پی‌آی
API versioning
روشی برای تغییر دادن ای‌پی‌آی بدون خراب کردن برنامه‌هایی که از نسخه قبلی استفاده می‌کنند.
نسخه‌بندی ای‌پی‌آی (API versioning) یعنی تغییرات قرارداد ای‌پی‌آی را با شماره یا نام نسخه مشخص کنیم تا برنامه‌هایی که با نسخه قبلی کار می‌کنند خراب نشوند.
تغییرات دو دسته‌اند: تغییر سازگار، مثل افزودن یک فیلد اختیاری، که برنامه‌های قبلی را خراب نمی‌کند؛ و تغییر ناسازگار، مثل حذف یا تغییر معنای یک فیلد، که نیاز به نسخه تازه دارد. روش رایج این است که نسخه قدیم مدتی کنار نسخه جدید بماند، کهنه‌شدن آن از پیش اعلام شود و به مصرف‌کنندگان فرصت مهاجرت داده شود. در ای‌پی‌آی‌های مالی این نظم برای اعتماد حیاتی است.
قسمت صوتی این واژه در ۱۴ فروردین ۱۴۰۶ در «یک دقیقه با ایران اوپن فاینانس» منتشر می‌شود.
واژه‌های مرتبط
قرارداد ای‌پی‌آیAPI contractتوافق دقیق درباره شکل درخواست‌ها، پاسخ‌ها و خطاهای یک ای‌پی‌آی که هر دو طرف به آن پایبندند.مشخصات اوپن‌ای‌پی‌آیOpenAPI Specificationاستانداردی رایج برای نوشتن قرارداد ای‌پی‌آی به شکلی که هم انسان و هم ماشین بتوانند آن را بخوانند.ای‌پی‌آی عمومی و خصوصیPublic and private APIای‌پی‌آی عمومی برای استفاده توسعه‌دهندگان بیرونی منتشر می‌شود؛ ای‌پی‌آی خصوصی فقط درون یک سازمان به کار می‌رود.