API 연결하기

1. API 관리 열고 새 API 키 만들기

PC의 www.textory.com에서 설정 → API 관리 → 새 API 키를 누릅니다. API 키 이름을 넣고(설명은 선택) 생성을 누르면 키가 이때 한 번만 보이니, 클립보드에 복사로 바로 저장하세요. 키는 서버 환경변수에만 보관하고, 웹 페이지 코드나 공개 저장소에는 넣지 마세요.

전체 보기

2. 발급된 키의 권한·사용량·상태 확인하기

목록에서 키의 권한, 사용량, 상태를 확인합니다. 사용량 칸의 일일 · 월간은 '이 API 키로 보낸 수 / 이 키에 걸린 한도'입니다. 쓰지 않는 키는 관리 칸의 휴지통(폐기)을 눌러 폐기하세요. 폐기는 되돌릴 수 없어요.

전체 보기

3. 연동 가이드에서 BASE URL과 인증 방식 확인하기

API 관리 화면 아래 Open API 연동 가이드에 BASE URL(https://openapi.textory.io)과 인증 헤더(Authorization: Bearer …)가 있고, 발송 경로는 「문서」의 폰 발송 (해외 지원) · 웹 발송에 정리되어 있습니다. 폰 전송은 POST /openapi/v1/messages/phone(연결된 Android 앱 필요), 웹 전송은 POST /openapi/v1/messages/web(발신번호 등록 · 크레딧 충전 필요)입니다.

전체 보기

4. 요청 보내고 결과 조회하기

recipients·contents·clientId를 채워 보냅니다(웹 전송은 등록한 발신번호를 sender에 넣습니다). 실행하면 실제로 발송되니 본인 번호로 테스트하세요. 응답의 messageId를 저장하고 GET /openapi/v1/messages/{id}로 수신자별 결과를 확인합니다. 같은 clientId로 중복 발송을 막고, 429는 Retry-After를 따르세요.