문서 홈

개발자

HTTP API 개요

FlexyAgents API의 개념적 맵: 인증, 에이전트 채팅, 스트리밍, 속도 제한, 플랫폼 API 레퍼런스 링크.

apireststreamingbearer token

FlexyAgents는 프로그램 방식 채팅 및 관련 작업을 위한 HTTPS 엔드포인트를 공개합니다. 배포 호스트가 베이스 URL을 결정합니다 — 일반 문서 예시가 아닌 환경 값을 사용하세요.

엔드포인트 표, 요청/응답 예시, Webhook 스키마는 마케팅 플랫폼 → API 페이지 및 공개 OpenAPI 사양(존재하는 경우)을 참조하세요.

인증

Bearer 토큰은 조직과 연결을 식별합니다. 키를 필요 최소한의 에이전트에 제한하세요.

제품이 지원하는 경우 단명 토큰 또는 로테이션 정책을 우선하세요.

채팅 및 스트리밍

POST형 엔드포인트는 메시지를 받고 모델 출력을 반환합니다. 스트리밍 버전은 SSE 또는 NDJSON 소비자용 증분 이벤트를 전송합니다.

연결 끊김을 적절히 처리하세요 — 클라이언트가 재시도해도 UX 재개로 부작용이 중복되면 안 됩니다.

속도 제한 및 오류

제한은 공유 인프라를 보호합니다. 429에는 지터가 있는 백오프를 적용하세요.

프로덕션에서는 오류 본문 로그를 절제하세요. 사용자 콘텐츠가 포함될 수 있습니다.

일부 지식 가져오기 엔드포인트는 호스팅형 월간 AI 이미지 설명 또는 미디어 전사 할당량이 소진되면 HTTP 402를 반환합니다. 오류 페이로드에 기계 판독 코드가 포함될 수 있습니다 — 통합 측에서 처리하고 관리자에게 Gemini 키 또는 플랜 상한 인상을 요청하세요.

스택 위에 구축

근거 있는 어시스턴트를 출시할 준비가 되셨나요?

체험판을 시작하거나, 롤아웃, 거버넌스, 엔터프라이즈 요건에 대해 상담하세요.