API가 발전함에 따라 새로운 방법, 매개 변수 및 논리가 등장합니다. 현재 클라이언트의 작업을 방해하지 않기 위해 API 버전이 사용됩니다. 버전 설정에 대한 여러 가지 접근 방식을 지원하므로 통합 업체는 안정적인 작동 위험없이 원하는 버전의 인터페이스를 사용할 수 있습
이는 플랫폼을 확장 할 때와 이전 클라이언트를 업데이트, 테스트 또는 서비스 할 때 중요합니다.
검증 방법
| 방법 | 설명 및 이점 |
|---|---|
| (PHP 3 = 3.0.6, PHP 4) | 가장 이해하기 쉽고 널리 사용되는 방법은 REST API에 편리합니다 |
| 헤더 수락 | 예: '수락: 응용 프로그램/vnd. api + json; 버전 = 2 '-버전에서 데이터를 분리합니다 |
| GraphQL 별칭/버전 필드 | 별칭을 통한 다른 버전: 'userV1', 'userV2' -점진적인 마이그레이션에 편리함 |
| 스키마 레벨 버전 | 각 버전의 OpenAPI/Swagger에서 별도의 다이어그램 및 모듈 |
구현 방법
'/v1/', '/v2/' 및 독립 경로가있는 API 구조
'수락' 및 'X-API-Version' 헤더 확인- GraphQL은 별칭 및 버전이 지정된 스키마 ('userV1', 'userV2') 를 지원합니다
- A/B 테스트 기능 생산 위험없이 새 버전
- 분석 및 마이그레이션을 위해 각 버전으로 전화 기록
비즈니스 및 통합 혜택
속도를 늦추지 않고 오래된 고객 지- 다세대 API 병렬 작동
- 이전 버전과의 호환성을 끊지 않고 새로운 기능을 안전
- 인프라 확장 및 업그레이드 유연성
- 제어 버전과 분석 버전 간의 완벽한 마이그레이션
특히 중요한 곳
여러 외부 클라이언트가있는 플랫- API 우선 접근 방식과 긴 수명주기를 가진 프로젝트
- 은행, 공급자, B2B 파트너와의 통합
- 수명이 긴 모바일 또는 IoT 클라이언트 시스템
API 버전 설정은 통합의 신뢰성과 유연성을위한 기초입니다. 형식 (REST, GraphQL 또는 gRPC) 에 관계없이 실패, 충돌 및 호환성 손실없이 인터페이스를 안전하게 개발할 수 있습니다.
문의하기
아래 양식을 작성해주시면 최대한 빨리 답변드리겠습니다.