개발자를 위한 API 레퍼런스
자체 앱을 워크스페이스에 연결합니다: REST API, 키와 범위, 오류, 요청 제한, 웹훅.
찾는 위치
⚙️ 설정 › API 레퍼런스 · 홈페이지 › 리소스 › API 레퍼런스
이 화면 열기
단계
- 사이드바의 “API 레퍼런스” 또는 홈페이지 “리소스” 메뉴의 “API 레퍼런스”를 엽니다.
- “시작하기”부터 읽습니다: “기본 URL과 규칙”, “인증”, “범위”.
- 그룹별로 “엔드포인트”를 찾아봅니다. 각각 매개변수, 요청 본문, 응답, 오류를 예제와 함께 보여 줍니다.
- 운영 전에 “오류와 상태 코드”, “요청 제한”, “웹훅(발신)”을 읽으세요. “OpenAPI JSON”으로 전체 사양을 내려받습니다.
문제 해결
API 키는 어떻게 받나요?
키는 요청에 따라 워크스페이스용으로 발급되며, 아직 앱에서 만들 수는 없습니다. 워크스페이스의 키는 AI 영역의 개발자 페이지에 나열되고, 워크스페이스 관리 담당자는 그곳에서 웹훅 엔드포인트를 추가하고 테스트할 수도 있습니다.
팁
- API는 서버에서만 호출하세요. 키를 웹 페이지나 모바일 앱에 넣지 마세요.
알아 두세요
- API 레퍼런스는 로그인하지 않고도 읽을 수 있습니다.
이 가이드에 대해 Synthia에게 질문하기
편하게 질문해 주세요. Synthia는 이 가이드의 내용만으로 답하고 단계 링크를 제공합니다. 가이드에 없는 내용이면 없다고 알려 드립니다.
이 페이지 공유
채팅 앱과 SNS(LINE, Slack, X, Facebook, iMessage 등)는 링크마다 하나의 미리보기를 링크의 언어로 만듭니다. 받는 사람 각자의 언어로 바뀌지 않습니다. 상대방 언어로 미리보기를 보내려면 그 언어의 링크를 복사해 보내세요.