Galon Cloud
Galon API v1

Galon Cloud 통합

프로젝트를 만들고 최소 권한 API 키를 발급한 뒤 허용된 도구를 확인하고 서버에서 API를 호출합니다.

빠른 시작

로그인하여 테스트 프로젝트를 만들고 필요한 범위만 가진 키를 생성합니다. GET /v1/tools를 호출하고 서비스 하나를 구성한 뒤 인수 테스트 후 별도의 live 키를 만듭니다.

export GALON_API_BASE="https://api.galon.ai"
export GALON_API_KEY="gln_test_..."

curl "$GALON_API_BASE/v1/tools"   -H "Authorization: Bearer $GALON_API_KEY"

인증 및 격리

API 키를 Authorization: Bearer 헤더로 전송합니다. 각 키는 하나의 tenant, 프로젝트 및 환경에 연결됩니다. 서버 측 비밀 관리자에만 보관하고 브라우저, 모바일 앱 또는 소스 저장소에는 절대 넣지 마십시오.

서비스 제한 키

mail:send, domain:lookup 또는 build:create 같은 정확한 범위만 부여합니다. 애플리케이션마다 키 하나를 사용하십시오. 통합에 모든 작업이 실제로 필요하지 않다면 서비스 와일드카드를 피하고 사용하지 않는 키는 즉시 폐기하십시오.

mail:send
domain:lookup
domain:read
build:create
build:read
artifact:read
job:read

비동기 job 및 멱등성

변경 작업은 job을 반환합니다. 안정적인 Idempotency-Key를 보내십시오. 같은 키와 의도는 같은 job을 반환하고, 같은 키에 다른 의도는 HTTP 409를 반환합니다. job endpoint를 확인하고 안전하거나 멱등한 요청만 재시도하십시오.

POST /v1/jobs
GET  /v1/jobs/{job_id}
POST /v1/jobs/{job_id}/cancel
GET  /v1/builds/{job_id}/artifacts

이메일 보내기

POST /v1/emails는 from_email, subject, text 또는 html, 그리고 to(주소 하나 또는 목록)를 받습니다. cc와 bcc는 선택 목록입니다. to, cc, bcc를 합쳐 서로 다른 수신자는 최대 50명이며, 각 수신자는 할당량과 과금 사용량에 집계됩니다. 각 수신자는 자신만의 원클릭 수신 거부 링크가 포함된 개별 사본을 받으므로 bcc 수신자는 절대 공개되지 않습니다. 차단된 수신자(반송, 불만 신고, 수신 거부)는 건너뜁니다. attachments는 filename, content(base64), 선택적 content_type을 가진 최대 10개 객체의 목록입니다. 인코딩된 메시지는 25MB 미만이어야 하며 실행 파일은 거부됩니다. scheduled_at(시간대가 포함된 ISO 8601, 최대 72시간 전)은 발송을 늦추며, 대기열에 있는 동안 POST /v1/emails/{job_id}/cancel로 취소할 수 있습니다. POST /v1/emails/batch는 첨부 파일 없는 1~100개 메시지를 담은 {"emails": [...]}를 받습니다. 각 메시지는 별도의 job이 되며 배치의 Idempotency-Key와 위치로 멱등성이 보장됩니다. 단일 수신자에는 여전히 to_email을 사용할 수 있습니다. 배치 등록만 원자적입니다(atomic=true). 실행과 전달은 서로 독립적입니다. 재시도에는 정확히 같은 순서의 목록이 필요하며 내용, 크기 또는 순서가 바뀌면 HTTP 409를 반환합니다.

POST /v1/emails
POST /v1/emails/batch
POST /v1/emails/{job_id}/cancel

오류

HTTP 401은 유효하지 않거나 만료된 자격 증명, 403은 부족한 범위, 409는 멱등성 또는 버전 충돌, 422는 잘못된 요청, 503은 일시적 사용 불가로 처리하십시오.

기계 판독 가능 참조

schema에는 OpenAPI 계약을, agent 지침에는 LLM 통합 가이드를 사용하십시오. 영어가 정본이며 경로, 필드, 범위 및 예시는 모든 번역에서 동일합니다.