API 접근

WallaWhats는 대시보드가 사용하는 것과 동일한 작업을 JSON HTTP API를 통해 노출합니다. 구독 관리 스크립트 작성, 자체 시스템으로 알림 기록을 가져오기, 또는 알림을 내부 도구와 통합하는 데 사용하세요. 모든 유료 티어에는 API 접근이 포함됩니다 — 플랜별 키 제한은 플랜 관리를 참조하세요.

1단계 — API 키 열기

사이드바에서 API 키(액세스 키 아래)를 클릭하세요.

2단계 — 키 생성

1. 키 생성을 클릭합니다.
2. 키에 이름(예: production-server, local-dev)을 지정합니다. 이름은 라벨일 뿐 — 권한에 영향을 주지 않습니다.
3. 생성을 클릭합니다.

전체 키 값은 한 번만 표시됩니다 — 즉시 시크릿 매니저에 복사하세요. WallaWhats는 해시와 짧은 접두사(bws_xxxxxxxx…)만 저장하므로 나중에 복구할 수 없습니다.

키를 비밀번호처럼 다루세요

키를 가진 사람은 누구나 계정에서 작업할 수 있습니다. 키를 시크릿 매니저에 저장하고, git에 절대 커밋하지 말고, 주기적으로 회전시키세요.

3단계 — 키 사용

모든 요청의 x-api-key 헤더에 키를 보냅니다:

curl -H "x-api-key: bws_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://api.wallawhats.com/subscriptions

사용 가능한 엔드포인트, 요청 본문, 응답 형식은 API 레퍼런스에 문서화되어 있습니다.

4단계 — 회전 또는 폐기

• 회전 — 새 키를 만들고 배포한 다음 이전 키를 삭제합니다. 설계상 "회전" 버튼은 없습니다; 생성 후 삭제로 전환을 원자적으로 만듭니다.
• 폐기 — 키 행 옆의 삭제를 클릭합니다. 키는 즉시 작동을 멈춥니다. 사용 중인 진행 중 요청은 401 Unauthorized를 반환합니다.

플랜 제한

플랜	API 키
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

제한에 도달하면 키 생성이 비활성화됩니다 — 먼저 이전 키를 삭제하거나 플랜을 업그레이드하세요.

다음은

요청/응답 스키마와 전체 엔드포인트 목록은 **API 레퍼런스 →**를 참조하세요.