---
term: "نسخه‌بندی ای‌پی‌آی"
english: "API versioning"
category: "اوپن فاینانس و API"
url: https://iranopenfinance.com/glossary/api-versioning
source: Iran Open Finance (ایران اوپن فاینانس) glossary
---

# نسخه‌بندی ای‌پی‌آی (API versioning)

> روشی برای تغییر دادن ای‌پی‌آی بدون خراب کردن برنامه‌هایی که از نسخه قبلی استفاده می‌کنند.

نسخه‌بندی ای‌پی‌آی (API versioning) یعنی تغییرات [قرارداد ای‌پی‌آی](/glossary/api-contract) را با شماره یا نام نسخه مشخص کنیم تا برنامه‌هایی که با نسخه قبلی کار می‌کنند خراب نشوند.

تغییرات دو دسته‌اند: تغییر سازگار، مثل افزودن یک فیلد اختیاری، که برنامه‌های قبلی را خراب نمی‌کند؛ و تغییر ناسازگار، مثل حذف یا تغییر معنای یک فیلد، که نیاز به نسخه تازه دارد. روش رایج این است که نسخه قدیم مدتی کنار نسخه جدید بماند، کهنه‌شدن آن از پیش اعلام شود و به مصرف‌کنندگان فرصت مهاجرت داده شود. در ای‌پی‌آی‌های مالی این نظم برای اعتماد حیاتی است.

Related: [قرارداد ای‌پی‌آی](https://iranopenfinance.com/glossary/api-contract.md)، [مشخصات اوپن‌ای‌پی‌آی](https://iranopenfinance.com/glossary/openapi.md)، [ای‌پی‌آی عمومی و خصوصی](https://iranopenfinance.com/glossary/public-private-api.md)