Gemini API는 장기 실행 작업의 효율성을 높이기 위해 이벤트 기반 웹훅(Event-driven Webhooks)을 도입
기존의 비효율적인 폴링(Polling) 방식 대신, 작업 완료 시 실시간 HTTP POST 페이로드(Real-time HTTP POST Payload)를 푸시(Push)하는 방식으로 변경
표준 웹훅(Standard Webhooks) 사양 준수 및 HMAC 기반 보안(HMAC-based Security)을 통해 안정성과 보안을 강화
모든 개발자가 Gemini API를 사용하여 웹훅(Webhooks)을 즉시 활용 가능하며, SDK 및 가이드 제공
본문에 따르면 Gemini API는 딥 리서치(Deep Research), 긴 비디오 생성(Long Video Generation), 배치 API(Batch API)를 통한 대량 프롬프트 처리 등 장기 실행 작업이 증가함에 따라, 기존 폴링(Polling) 방식의 비효율성을 해결하고자 웹훅(Webhooks)을 도입했다.
폴링(Polling) 방식: 작업 완료 여부를 확인하기 위해 지속적으로 GET 요청 전송
문제점: 불필요한 리소스 낭비 및 지연 시간(Latency) 증가
웹훅(Webhooks) 도입 효과: 작업 완료 시점에 푸시 알림(Push Notification) 전송으로 효율성 향상
결과적으로 웹훅(Webhooks)은 자원 낭비를 줄이고 실시간 응답(Real-time Response)을 가능하게 하여 사용자 경험을 개선한다.
글에 따르면 Gemini API는 웹훅(Webhooks)의 안정적인 운영을 위해 다양한 보안 및 안정성 메커니즘을 적용했다.
표준 웹훅(Standard Webhooks) 사양 준수: 호환성(Compatibility) 및 상호 운용성(Interoperability) 보장
HMAC 기반 보안: webhook-signature, webhook-id, webhook-timestamp 헤더를 사용하여 요청의 무결성(Integrity) 검증
at-least-once delivery 보장: 자동 재시도(Automatic Retries)를 통해 메시지 손실 방지
이러한 노력은 데이터 미저장 정책(Zero-Retention Policy)과 함께, 웹훅(Webhooks) 시스템의 신뢰성을 높이는 데 기여한다.
본문에서는 웹훅(Webhooks) 설정을 프로젝트 레벨(Project Level) 및 요청 레벨(Request Level)에서 유연하게 구성할 수 있도록 지원한다.
프로젝트 레벨 설정: HMAC(HMAC) 기반 보안을 통해 전체 프로젝트에 대한 웹훅(Webhooks) 설정
요청 레벨 설정: JWKS(JWKS) 기반 보안을 통해 특정 작업에 대한 웹훅(Webhooks) 설정
Python SDK 예시: 동적 웹훅(Dynamic Webhook) 설정을 위한 코드 스니펫 제공
이러한 유연성은 개발자가 다양한 요구사항에 맞춰 웹훅(Webhooks)을 적용할 수 있도록 돕는다.
글에 따르면 Gemini API는 웹훅(Webhooks) 도입과 함께 개발자 친화적인 환경을 구축하기 위해 노력했다.
웹훅(Webhooks) 문서: 전체 이벤트 카탈로그(Event Catalog) 및 보안 설정 방법 제공
쿡북(Cookbook): 웹훅(Webhooks)을 활용한 엔드투엔드(End-to-End) 통합 가이드 제공
SDK 지원: Python SDK를 통해 웹훅(Webhooks) 설정 및 관리 용이
이러한 지원은 개발자가 웹훅(Webhooks)을 쉽게 이해하고 적용할 수 있도록 돕고, Gemini API의 확장성(Scalability) 및 사용성(Usability)을 향상시킨다.
