6월 업데이트에서는 AI 기반 CLI 작업, 더 깔끔한 가져오기, OAuth 2.0 자동 토큰 갱신, 테스트/구성 워크플로우 개선을 통해 일상적인 API 작업을 더 쉽게 자동화하고 안정적으로 실행할 수 있도록 했습니다.
이번 릴리스의 핵심은 API 팀이 반복적으로 시간을 쓰는 지점을 줄이는 것입니다.
- AI 에이전트가 실제 Apidog 프로젝트 리소스를 안전하게 다루도록 지원
- Postman/OpenAPI/Swagger 가져오기 후 수동 정리 감소
- OAuth 2.0 보호 API 요청 중 토큰 만료로 인한 중단 최소화
- 테스트 스위트, 예약 작업, 웹 앱 요청 헤더 구성 개선
새로운 업데이트
Apidog CLI: AI 기반 API 워크플로우 실행 레이어
Apidog CLI는 AI 기반 API 워크플로우의 실행 레이어 역할을 강화하고 있습니다.
목표는 사용자가 모든 CLI 명령을 직접 익히는 것이 아니라, AI 에이전트가 Apidog 프로젝트 리소스를 구조화된 방식으로 읽고, 변경하고, 검증하고, 내보내고, 테스트할 수 있도록 하는 것입니다.
이번 업데이트에서 Apidog CLI는 다음 작업을 지원합니다.
- Apidog 프로젝트 리소스에서 동작하는 AI 에이전트 실행 레이어로 활용
- 테스트 케이스 실행
- 시나리오 케이스에서 엔드포인트, 테스트 케이스, 다른 시나리오 참조
- 네이티브 형식 및 OpenAPI 형식 내보내기 시 더 세분화된 범위 제어
예를 들어 AI 에이전트가 API 테스트를 생성하거나 기존 시나리오를 수정하는 흐름에서는 다음과 같은 패턴을 만들 수 있습니다.
1. AI 에이전트가 Apidog 프로젝트 리소스를 읽음
2. 필요한 엔드포인트 또는 테스트 케이스를 참조
3. 변경 사항 또는 테스트 시나리오를 생성
4. CLI로 실행 또는 검증
5. 필요한 범위만 내보내기
Apidog Skills와 함께 사용하면 CLI는 AI 에이전트에 더 명확한 작업 지침과 안전한 실행 경계를 제공합니다. 에이전트는 Apidog 리소스 사용 방식을 더 잘 이해하고, 생성한 변경 사항을 다시 작성하기 전에 검증하며, 추측을 줄인 상태로 API 작업을 완료할 수 있습니다.
CLI는 자연어 AI 지침과 구조화된 Apidog 프로젝트 작업 사이의 브리지 역할을 합니다.
가져오기 및 내보내기 개선
이번 릴리스는 Postman에서 데이터를 이전하거나 OpenAPI/Swagger 기반으로 API 정의를 관리하는 팀에 유용한 가져오기/내보내기 개선을 포함합니다.
Postman API 가져오기 후 정리 감소
Postman API를 통해 데이터를 가져올 때 Apidog는 이제 변수 이름의 공백을 제거할 수 있습니다.
예를 들어 다음과 같은 변수 이름은 가져오기 후 사용하기 불편할 수 있습니다.
base url
access token
user id
공백 제거를 적용하면 다운스트림 요청, 스크립트, 환경 변수 참조에서 더 일관된 이름을 사용할 수 있습니다.
baseurl
accesstoken
userid
또한 Postman API를 통해 워크스페이스를 가져올 때, Apidog는 워크스페이스 생성자를 기반으로 혼란스러운 "내 워크스페이스" 이름을 변경할 수 있습니다. 여러 워크스페이스를 가져오는 팀은 가져온 데이터의 출처를 더 쉽게 식별하고 정리할 수 있습니다.
OpenAPI 및 Swagger 가져오기/내보내기 개선
OpenAPI 및 Swagger 가져오기/내보내기는 객체 유형 매개변수와 참조 유형 매개변수를 지원합니다.
즉, 더 복잡한 API 사양 구조를 가져오거나 내보낼 때 수동으로 보정해야 하는 경우가 줄어듭니다.
| 이전 | 현재 |
|---|---|
|
|
OAuth 2.0: 자동 토큰 갱신 지원
OAuth 2.0 인증은 이제 자동 토큰 갱신을 지원합니다.
액세스 토큰이 만료되었거나 만료가 임박한 경우, Apidog는 자동으로 토큰을 갱신할 수 있습니다. 따라서 사용자는 요청 중간에 다시 인증하거나 새 토큰을 복사해 붙여 넣을 필요가 줄어듭니다.
OAuth로 보호된 API를 반복적으로 디버깅하는 경우 특히 유용합니다.
기존 흐름:
요청 실행 → 토큰 만료 → 요청 실패 → 재인증 → 토큰 복사 → 다시 요청
개선된 흐름:
요청 실행 → 토큰 만료 감지 → 자동 갱신 → 요청 계속
API 디버깅, 테스트, 반복적인 요청 검증 중 인증으로 인한 중단을 줄일 수 있습니다.
사용자 피드백 기반 개선 사항
MCP 클라이언트 호환성 개선
Apidog는 MCP 클라이언트 호환성을 개선했으며, 이제 비표준 스키마를 더 안정적으로 구문 분석할 수 있습니다.
이는 MCP 서버 또는 도구의 스키마 출력이 예상 형식을 엄격히 따르지 않는 경우에 유용합니다. 스키마 차이로 초기에 실패하는 대신, Apidog는 더 많은 실제 MCP 응답을 처리하고 도구 통합 및 디버깅 성공률을 높일 수 있습니다.
테스트 스위트에서 이름으로 정적 단계 검색
이제 테스트 스위트에 정적 단계를 추가할 때 이름으로 검색할 수 있습니다.
엔드포인트, 테스트 케이스, 시나리오가 많은 프로젝트에서는 긴 목록을 직접 스크롤하는 대신 이름으로 필요한 단계를 빠르게 찾을 수 있습니다.
예시 워크플로우:
1. 테스트 스위트 열기
2. 정적 단계 추가 선택
3. 단계 이름 검색
4. 필요한 엔드포인트/테스트 케이스/시나리오 추가
예약된 작업에 "8시간마다" 옵션 추가
예약된 작업에 "8시간마다" 실행 옵션이 추가되었습니다.
다음과 같은 워크플로우에 사용할 수 있습니다.
- 반복적인 자동 테스트
- 모니터링 성격의 API 검사
- 주기적인 API 유효성 검증
- 하루 3회 실행이 필요한 회귀 테스트
Apidog 웹 앱: 자동 생성 헤더 구성 지원
Apidog 웹 앱은 이제 자동 생성 헤더 구성을 지원합니다.
웹 앱 사용자는 생성된 요청 헤더를 팀 또는 프로젝트 요구 사항에 맞게 조정할 수 있습니다. 브라우저 기반 워크플로우에서도 요청 동작을 더 세밀하게 제어할 수 있습니다.
버그 수정 및 사소한 개선 사항
이번 달에는 다음 수정 사항과 개선 사항도 포함되었습니다.
- 자식 브랜치에서 대규모 테스트 시나리오를 선택할 때 성능이 향상되어 타임아웃 오류 가능성이 줄어듭니다.
- 스프린트 브랜치 및 일반 브랜치 목록에서 브랜치 ID 표시 및 복사를 지원합니다.
- macOS가 인트라넷 요청을 보낼 수 없을 때 더 사용자 친화적인 메시지가 표시됩니다.
- 새 모듈로 Apidog 데이터를 다시 가져올 때 서비스 기본 URL이 가져와지지 않고 엔드포인트가 지정된 서비스에 바인딩되지 않던 문제를 수정했습니다.
- 요청 헤더에 추가되도록 설정된 OAuth 1.0 인증이 실제로 요청 헤더에 추가되지 않던 문제를 수정했습니다.
- Basic Auth가 중국어 변수를 사용할 때 생성된 엔드포인트 요청 코드가 올바르게 작동하지 않던 문제를 수정했습니다.
- 엔드포인트가 HTTP를 사용할 때 생성된 요청 코드가 잘못 HTTPS를 사용하던 문제를 수정했습니다.
- 시나리오 단계가 원시 형식 응답 본문을 참조할 때 CLI 시나리오 실행 시
"예상치 못한 토큰"오류가 보고될 수 있던 문제를 수정했습니다. - 자동화된 테스트 시나리오가 비정상적으로 종료된 후에도 테스트 보고서 세부 정보가 계속 실행 중으로 표시되던 문제를 수정했습니다.
- 루트 폴더에서 시나리오 케이스를 실행한 후 해당 보고서가 테스트 보고서 목록에 표시되지 않던 문제를 수정했습니다.
- Apidog 웹 앱을 새로 고칠 때 프로젝트가 자동으로 메인 브랜치로 다시 전환되던 문제를 수정했습니다.
- 브랜치 가져오기 및 Markdown에 엔드포인트를 삽입할 때 태그 필터 옵션에 내용이 없던 문제를 수정했습니다.
- 여러 모듈과 서비스가 있는 Apidog 파일을 가져올 때 비기본 서비스가 반복적으로 추가되던 문제를 수정했습니다.
- Apidog 데이터를 가져올 때 Markdown 문서 태그가 올바르게 가져와지지 않던 문제를 수정했습니다.
- 일부 경우에 엔드포인트를 메인 브랜치로 병합한 후에도 충돌이 계속 표시되던 문제를 수정했습니다.
- 일부 경우에 SSE 엔드포인트를 디버깅할 때 프론트엔드 오류가 발생할 수 있던 문제를 수정했습니다.
- On-Premises 프로젝트 통계가 기본 모듈의 데이터만 계산하던 문제를 수정했습니다.
- 팀 세부 정보 페이지에서 다중 모듈 Apidog 파일을 가져올 때 엔드포인트가 기본 모듈로 잘못 가져와지던 문제를 수정했습니다.
- 수정 사항을 제출한 후 일부 경우에 변경 사항이 사라지던 문제를 수정했습니다.
- 비밀번호 변경 시 이메일 인증 흐름에서 잘못된 오류 메시지가 표시되던 문제를 수정했습니다.
개발팀에 의미하는 바
이번 업데이트는 사람, AI 에이전트, API 사양, 자동화된 테스트가 함께 동작하는 워크플로우를 더 안정적으로 만듭니다.
| 영역 | 개선 사항 | 중요성 |
|---|---|---|
| AI 기반 CLI 워크플로우 | CLI는 AI 에이전트가 실제 Apidog 프로젝트 리소스에서 작업하고, 테스트 케이스를 실행하고, 기존 자산을 참조하고, 내보내기를 더 정확하게 제어하는 데 도움이 될 수 있습니다. | AI 에이전트가 구조화되지 않은 정보에서 추측하는 대신 구조화된 프로젝트 컨텍스트를 사용하여 API 작업을 더 쉽게 완료할 수 있습니다. |
| 가져오기 및 내보내기 | Postman API 가져오기는 변수 이름을 정리하고 워크스페이스 이름을 명확히 할 수 있습니다; OpenAPI/Swagger 가져오기/내보내기는 객체 유형 및 참조 유형 매개변수를 지원합니다. | 마이그레이션 후 정리 작업이 줄어들고 API 사양 교환이 더 완벽해집니다. |
| 인증 | OAuth 2.0 토큰이 자동으로 갱신될 수 있습니다. | API 디버깅 및 테스트 중 중단이 줄어듭니다. |
| MCP 호환성 | MCP 클라이언트가 더 많은 비표준 스키마를 구문 분석할 수 있습니다. | 실제 MCP 도구 및 서버와의 호환성이 향상됩니다. |
| 테스트 워크플로우 | 정적 단계를 더 쉽게 찾을 수 있으며, 예약된 작업은 추가적인 8시간 간격을 지원합니다. | 더 빠른 테스트 스위트 설정과 더 유연한 반복 테스트 실행. |
| 웹 앱 구성 | Apidog 웹 앱에서 자동 생성 헤더를 구성할 수 있습니다. | 브라우저 기반 워크플로우에서 요청 동작에 대한 더 많은 제어 권한. |
정리하면 다음과 같습니다.
AI 에이전트 → 더 나은 프로젝트 컨텍스트 확보
가져온 데이터 → 수동 정리 감소
OAuth 요청 → 토큰 만료 중단 감소
테스트 워크플로우 → 검색 및 예약 옵션 개선
웹 앱 요청 → 헤더 구성 제어 강화
대화에 참여하세요
동료 API 엔지니어 및 Apidog 팀과 연결하세요.
- 실시간 토론 및 지원을 위해 Discord 커뮤니티에 참여하세요.
- 기술적인 대화를 위해 Slack 커뮤니티에 참여하세요.
- 최신 업데이트를 위해 X (Twitter)를 팔로우하세요.
추신. 모든 업데이트에 대한 자세한 내용은 Apidog Changelog를 확인하세요.
감사합니다,
Apidog 팀 드림
Top comments (0)