PUSH API · v1a
인증과 키
모든 공개 API 인증은 HTTPS의 Authorization: Bearer 헤더를 사용합니다. 키 문자열을 URL, 로그, 스크린샷이나 지원 문의에 넣지 마세요.
| 종류 | 보관 위치 | 할 수 있는 일 |
|---|---|---|
pk_test_… / pk_live_… | 앱의 SDK 설정 | 공개 키. installations:enroll 권한으로 앱 설치를 등록합니다. 발송이나 사용자 재연결은 할 수 없습니다. |
sk_test_… / sk_live_… | 신뢰할 수 있는 서버의 비밀 저장소 | 서버 키. 부여된 권한만 수행합니다. 앱 번들·브라우저·공개 문서에 넣지 마세요. |
gsk_test_… / gsk_live_… | 신뢰할 수 있는 서버의 비밀 저장소 | 통합 발송 키. 같은 프로젝트 환경에서 선택한 2–8개 앱에 /v1/project-messages로 발송을 접수합니다. 기존 앱별 키와 SDK 키는 그대로 유지합니다. 앱에 넣지 마세요. |
it_… | SDK가 관리하는 기기 저장소 | 앱 설치 등록 응답의 비밀 토큰. 자기 앱 설치의 지원된 변경만 허용하며 다른 앱 설치에는 사용할 수 없습니다. |
| FCM/APNs 자격증명 | 운영자가 관리하는 푸시 서비스 연결 | 푸시 서비스에 인증하는 비밀입니다. Kits 공개 키나 서버 키와 다르며 SDK에 넣지 않습니다. |
| 대시보드 로그인 세션 | 대시보드 브라우저 | 사람의 관리 작업용 세션입니다. 서버 키를 대신하지 않고 SDK API 주소로도 사용하지 않습니다. |
키와 환경을 맞추기
- 앱별 키와 대상 앱 설치는 같은 앱 환경에 속해야 해요. 통합 발송 키는 발급할 때 선택한 같은 프로젝트 환경의 앱들에만 사용할 수 있어요.
- 테스트 발송에는 messages:send, 결과 조회에는 messages:read 권한을 사용합니다. 필요한 권한만 부여하세요.
- 고객 SDK의 API 주소는 https://kits-api.marco-corp.com으로 고정돼요. 별도 URL·HTTP 허용 옵션은 없어요. 아래 curl 예제의 API origin은 SDK 초기화 옵션이 아니에요.
- 신규 관리형 연동의 저장소는 SDK가 관리해요. 아래 구형 core 예시를 유지하는 앱만 기존 storageNamespace를 호환 경로에서 그대로 유지하세요. 키를 바꾸거나 앱을 업데이트한다고 저장소 이름을 바꾸거나 지우지 마세요.
권한 확인
각 API 레퍼런스의 인증 항목에 허용된 인증 방식과 필요한 권한이 표시됩니다. OR로 나뉜 항목은 대안이며 모두 동시에 필요한 것이 아닙니다.
API별 권한 보기