Routebase

Routebase는 하나의 명세를 하위 모든 것의 진실 공급원으로 다룬다. 버전을 한 번 공개하면 문서 포털, 목 서버, 테스트, 모니터가 모두 같은 계약을 읽는다. 바꿀 곳이 한 곳뿐이고, 맞춰야 할 흩어진 사본이 없다. 익숙한가. 바로 그 어지러움을 정리해 주는 것이 이것이다.

엔드포인트와 스키마, 버전을 갖춘 비주얼 에디터에서 계약을 설계하므로 아무도 YAML을 손으로 편집할 필요가 없다. 재사용 가능한 스키마는 엔드포인트 사이의 반복을 줄이고, 명세 분기는 본선을 건드리지 않고 변경을 작성하게 해 준다. 들여쓰기와 싸우기보다 스키마를 클릭해 나가는 쪽을 선호하는 팀을 겨냥한다. 그게 핵심이다. 엔드포인트가 바뀔 때마다 손으로 쓴 OpenAPI 파일을 문서 포털, 목 서버, 테스트 스위트와 몇 시간씩 맞춰야 한다면, 재사용 가능한 스키마를 갖춘 비주얼 에디터가 그 수고의 대부분을 없애 준다.

버전을 공개하면 명세에서 곧바로 문서 포털과 목 서버가 만들어진다. 프런트엔드 개발자는 실제 백엔드가 아직 진행 중일 때 목을 기준으로 개발하므로 계약에서 쓸 수 있는 엔드포인트까지의 대기 시간이 줄어든다. 형태를 추측할 일이 없다. 문서 포털용 사용자 지정 도메인은 Pro 플랜 이상에서 쓸 수 있다. 공개는 한 번. 문서와 목은 최신 상태를 유지한다.

Routebase는 MCP 서버를 기본으로 제공하며, 모든 기능을 에이전트 도구로 노출한다. 에이전트는 팀이 쓰는 것과 같은 인터페이스로 엔드포인트를 만들고, 테스트 스위트를 실행하고, 명세를 lint할 수 있다. 접착 코드를 쓸 필요가 없으며, AI 에이전트가 API 워크플로에 어떻게 맞는지 시험할 때 이 점이 중요하다. 에이전트에게는 자기만의 차선이 주어진다.

예약 모니터가 라이브 응답을 명세에 대해 재생하고, 빠진 필드와 타입 불일치부터 문서화되지 않은 추가까지 모든 차이를 표시한다. 각 차이는 필드 단위 차이로 분류되므로, 호환성을 깨는 변경은 모호한 경고가 아니라 구체적인 델타로 나타난다. 문서가 조용히 거짓말하지 않게 막아 주는 부분이 바로 이것이다. 믿어 달라, 이건 들리는 것보다 더 중요하다.

명세 분기에서 작성하고, 병합 요청을 열고, 리뷰를 통과한 것을 출시한다. 호환성을 깨는 변경과 충돌 감지는 병합 전에 실행되므로, 위험한 편집은 아직 고치기 쉬울 때 드러난다. 개발자가 코드에 기대하는 것과 같은 리뷰 규율을 API 계약 자체에 가져오며, 이는 잘못된 스키마 변경이 모바일 클라이언트가 옛 형태로 이미 출시된 뒤 운영 환경에서 터지는 대신 병합 요청에서 잡힌다는 뜻이다. 리뷰는 까다로운 것을 일찍 잡는다. 그게 이득이다.

거버넌스 규칙은 에디터에서 직접, 또는 MCP를 통한 에이전트에서 명세를 스타일 가이드에 따라 lint한다. Pro 플랜에서는 거버넌스 검사와 함께 보안 스캔도 얻는다. 많은 API 사이의 일관성을 중시하는 팀에게 이 계층은 스타일이 갈라지지 않게 막아 준다. 일관된 API는 시간이 지나도 문서화하고 소비하고 지원하기가 더 쉽다.