Bubble.io에서 API 엔드포인트를 버전 관리하는 방법은 무엇인가요?

단계들:

단계 1: 버전을 알아두세요
Bubble.io는 기본적으로 앱의 다양한 버전을 관리합니다 - 실제 버전과 개발 버전이라는 것입니다. 각 버전은 API 호출에 대한 다른 엔드포인트 URL을 제공합니다.

단계 2: 개발 관행을 확립하세요
앱의 개발 버전에서 새로운 기능, 변경 사항 그리고 테스트를 수행하세요. 이렇게 하는 것은 이러한 변경 사항이 즉시 기존의 실제 앱 사용자에게 영향을 주지 않게 하는 위험을 완화합니다.

단계 3: URL 경로를 통한 버전화
버전을 구별하기 위해 고유한 URL 경로를 사용하세요. 예를 들어, 개발 버전의 URL 패턴은 https://yourapp.bubbleapps.io/version-test/api/1.1/wf/endpoint와 같이 되며, 실제 버전은 https://yourapp.bubbleapps.io/api/1.1/wf/endpoint와 같이 됩니다.

단계 4: 브랜치 분기
메인 실제 버전과 개발 버전 외에도, 특정 개발 워크플로를 위한 브랜치를 생성할 수 있습니다. 이는 각 브랜치에 대해 https://yourapp.bubbleapps.io/branch-id/api/1.1/obj/endpoint와 같은 URL을 가질 수 있음을 의미합니다.

단계 5: 버전을 명확하게 전달하세요
기능을 릴리스하거나 업데이트할 때, API 사용자에게 어떤 URL을 사용해야 하는지 알립니다. 일반 유저와 안정적인 경험에 의존하고 있는 애플리케이션은 API의 실제 버전을 가리키게 해야 합니다.

단계 6: 경로에서 버전 번호 업데이트
호환성을 깨는 변경을 만들 때, 경로에서 버전 번호를 증가시킵니다. 예를 들어, API 버전 1에서 버전 2로 업그레이드하는 경우 경로 세그먼트는 /api/1.1/에서 /api/2.0/로 변경됩니다.

단계 7: 후방 호환성 유지
가능한 경우, 이전 버전을 유예 기간 동안 운영상태로 유지합니다. 이는 사용자가 변경 사항에 적응하고 자신의 애플리케이션을 적절히 업데이트할 시간을 줍니다.

단계 8: 문서 업데이트
API 문서가 모든 가능한 버전과 브랜치를 반영하도록 합니다. 각 새 릴리스로 변경된 내용을 문서화하고 사용자가 그들의 통합을 업데이트하는 데 필요한 마이그레이션 경로를 제공합니다.

단계 9: 이전 버전을 책임감 있게 철회하세요
이전 버전을 해지하기로 결정하면, 이를 먼저 잘 알려야 합니다. 새로운 버전으로 이전하는 방법에 대한 명확한 지침을 제공하고 이전 기간 동안 지원을 제공하세요.

버전 관리는 애플리케이션이 API 사용자에게 과도한 어려움을 초래하지 않으면서 발전할 수 있음을 보장하는 중요한 요소입니다. 이는 개발자가 개선과 새로운 기능에 집중하는 동안 사용자가 일관되고 신뢰할 수 있는 서비스를 계속 즐길 수 있게 합니다. 이 가이드를 따르면 Bubble.io API에 효과적인 버전 관리 전략을 구현하는 데 도움이 됩니다.