‏Routebase: داکیومنت، Mock و تست API از یه spec واحد

Routebase یه پلتفرم برای طراحی، تست و داکیومنت کردن APIهاست که همه‌چیزش دور یه spec زنده از نوع OpenAPI (یعنی یه فایل استاندارد که endpointها و ساختار داده‌های API رو توصیف می‌کنه) می‌چرخه. ایدهٔ اصلی اینه که spec رو یه بار عوض کنی و داکیومنت، mock server، تست‌ها و مانیتورها همه با یه publish دنبالش بیان، که داکیومنت از کد واقعی عقب نیفته.

روند کار چهار مرحله داره. اول قرارداد API رو تو یه ادیتور بصری طراحی می‌کنی یا spec فعلی‌ت رو import می‌کنی. بعد یه نسخه publish می‌کنی و Routebase از روش پورتال داکیومنت و mock server (یعنی یه سرور جعلی که جواب‌های نمونه برمی‌گردونه) می‌سازه. تیم فرانت روی همین mock کار می‌کنه و QA تست‌ها رو تو CI اجرا می‌کنه. آخرش مانیتورها جواب‌های واقعی رو با spec مقایسه می‌کنن.

این مقایسه همون چیزیه که بهش drift می‌گن، یعنی وقتی API واقعی کم‌کم با چیزی که داکیومنت می‌گه فرق می‌کنه. مانیتورهای زمان‌بندی‌شده فیلدهای جاافتاده، نوع‌های اشتباه و فیلدهای مستندنشده رو پیدا می‌کنن و تغییرات breaking رو با diff در سطح فیلد نشون می‌دن. خود spec هم مثل کد branch و merge request داره و قبل از merge تغییرات breaking چک می‌شن.

بخش تست هم جدیه. هر تست یه درخواست HTTP ساده‌ست که ده نوع احراز هویت رو پشتیبانی می‌کنه (از Bearer و API key تا OAuth2 و AWS SigV4) و assertionها اعلانی‌ان: شش نوع (status، body، header، JSON path، latency، schema) با ده عملگر، پس اسکریپتی برای نگه‌داری نیست. سازنده‌ها می‌گن می‌شه با این جای Postman رو گرفت و collectionهای Postman و Insomnia هم import می‌شن. اسکن OWASP API Top 10 هم کنارش هست.

هر workspace یه سرور MCP داخلی داره (یعنی پروتکلی که ایجنت‌هایی مثل Claude یا Cursor باهاش ابزارها رو صدا می‌زنن)، پس ایجنت‌ها می‌تونن با همون دسترسی‌های تیم endpoint بسازن، lint کنن و تست اجرا کنن. نسخهٔ 1.10.0 که ۶ اکتبر ۲۰۲۶ اومد، به پورتال‌ها امتیاز «آمادگی برای ایجنت» اضافه کرد و اگه درخواست با هدر Accept: text/markdown بیاد، به جای HTML نسخهٔ Markdown صفحه رو برمی‌گردونه.

پلن رایگان برای ۱ کاربر و ۲ پروژه با ۱۰۰۰ درخواست mock در ماهه. Starter نفری ۹ دلار، Pro نفری ۱۹ دلار و Enterprise نفری ۳۹ دلار در ماهه (سالانه)، که Enterprise حداقل ۲۵ صندلی می‌خواد. داده‌ها به انتخاب خودت تو اروپا یا آمریکا روی Azure نگه داشته می‌شن.

نکات کلیدی:

• یه spec از نوع OpenAPI منبع اصلی داکیومنت، mock، تست و مانیتوره
• مانیتورها drift بین API واقعی و spec رو با diff در سطح فیلد نشون می‌دن
• تست‌ها ده نوع احراز هویت و شش نوع assertion بدون اسکریپت دارن
• سرور MCP داخلی برای کار ایجنت‌ها با همون دسترسی‌های تیم
• نسخهٔ 1.10.0 پاسخ Markdown برای هدر Accept: text/markdown اضافه کرد
• پلن رایگان دائمی و قیمت Pro نفری ۱۹ دلار در ماه (سالانه)