API 레퍼런스

전체 고객용 인터페이스를 하나의 계약으로.

고객용 엔드포인트는 /api/v1 아래에서 사용할 수 있습니다. 기존 /api 접두사는 대시보드에서 계속 사용할 수 있지만, 새 서버 연동에는 버전이 지정된 기본 URL을 사용해야 합니다.

63개의 문서화된 작업8개의 리소스 그룹OpenAPI 3.1 기계가 읽을 수 있는 계약

인증 경계

제품 연동에는 워크스페이스 API 키를 사용하며, 이 키로 계정 사용량, 분석, API 키 메타데이터도 읽을 수 있습니다. 결제 변경과 API 키 생성 또는 폐기에는 HTTP 전용 브라우저 세션이 필요하며 그에 맞게 표시되어 있습니다.

리소스

오류 엔벨로프

JSON 오류는 예측 가능한 하나의 엔벨로프를 사용합니다. 상태 코드로 잘못된 입력, 인증, 존재하지 않는 리소스, 충돌, 결제 필요, 안전 차단, 사용량 한도를 구분합니다.

오류 응답
{
  "error": {
    "message": "The sender domain is not verified",
    "status": 403
  }
}

버전 관리

날짜 기반 API 버전이 이 계약을 식별합니다. 하위 호환되는 필드는 같은 버전 안에서 추가될 수 있습니다. 호환되지 않는 변경에는 새 버전의 기본 경로와 문서화된 전환 절차가 필요합니다.

탐색
{
  "version": "2026-09-07",
  "baseUrl": "https://sendhq.cc/api/v1",
  "openapi": "https://sendhq.cc/openapi.json"
}