소스와 키
기성 통합 외에도 GetMyBot은 커넥터 (소스 섹션)와 자격 증명 (키 섹션)을 통해 임의의 HTTP API와 작동할 수 있습니다. 커넥터는 어디에 요청할지를, 키는 어떻게 인증할지를 설명합니다. 소스에 요청 및 소스에 쓰기 액션이 이들을 사용합니다.
커넥터 (소스)
소스 → 커넥터 섹션. 커넥터에는 이름, 유형, 기본 URL, 연결된 자격 증명 및 헤더가 있습니다:
- REST — 모든 HTTP/JSON API.
- OzmaDB — OzmaDB/FunDB 인스턴스; 기본 URL에 REST API 인스턴스 루트를 지정하며, 익명 뷰에 대한 요청이 단순화됩니다.
- IMAP — '곧 출시'로 표시됨.
테스트 버튼은 테스트 요청을 실행하고 상태와 지연(또는 오류)을 표시합니다 — URL과 키가 올바른지 확인하기 편리합니다.
자격 증명 (키)
키 → 자격 증명 섹션. 비밀은 암호화된 형태로 저장됩니다. 유형:
- API 키 — 키 + 헤더 이름 (기본값:
Authorization). - Bearer 토큰 —
Authorization: Bearer헤더의 토큰. - OAuth2 (password) — Token URL, Client ID/Secret, 로그인, 비밀번호, scope.
- OAuth2 (refresh) — Token URL, Client ID/Secret, refresh 토큰, scope.
OAuth2의 경우 플랫폼이 자동으로 토큰을 가져오고 캐시하며, 만료 시 및 401 응답 시 갱신합니다. refresh 토큰 교체도 저장됩니다. 편집 시 비밀 필드가 비어 있으면 '변경하지 않음'을 의미합니다.
반응에서 읽기 및 쓰기
- 소스에 요청 (
ds_query) — 커넥터를 통해ctx로 데이터를 읽습니다: 경로, 배열에 대한 JSONPath 및 결과의ctx키를 지정합니다. 이후 배열은 목록 반복으로 순회합니다. - 소스에 쓰기 (
ds_write) — JSON 형식 본문으로 데이터를 전송합니다 (POST/PUT/DELETE).
저장된 커넥터 없이 일회성 요청에는 웹 요청 액션이 있고, 페이지 텍스트 다운로드에는 URL 로드가 있습니다 (액션 참조).