imsend 개발자 문서

2026-09-24 — 연동 표준(보장·키 교체·공유 지갑) · 웹훅 · 대량 이메일 광고 통제

기존 API 호출은 그대로 동작합니다. 바뀐 동작은 대량 이메일 광고 통제뿐입니다.

• 신규 PUT /api/admin/tenants/{id} 하위 가맹점 보장(멱등) · POST …/api-keys/rotate 키 교체 · 공유 지갑 wallet_mode(GET /api/admin/wallet, …/usage) — 리셀러 API › 연동 표준
• 신규 웹훅 /api/v1/webhook(HMAC 서명, 적어도 한 번 전달) — SMS API › 웹훅
• 변경 POST /api/v1/email/send/bulk: 광고(adType:"ad" 또는 제목·본문 (광고))면 야간(21~08시, 예약은 예약 시각 기준) 400 NIGHT_AD_BLOCKED, 수신거부 주소 제외(optoutFiltered), 제목에 (광고) 보장. 예약 배치도 발송 시각에 다시 확인해 야간이면 08시 이후로 미룹니다
• 추가 필드 /api/v1/sms/balance·/api/v1/tenant/billing-type 에 walletMode

2026-09-24 — OpenAPI 계약(/openapi/imsend-v1.yaml) 공개

가맹점 API(/api/v1/**)와 리셀러 API(/api/admin/**)의 요청·응답·오류 코드를 기계가 읽을 수 있는 OpenAPI 3.1 문서로 공개합니다. API 동작은 바뀌지 않습니다. 코드 생성·응답 필드 확인은 이 계약을 기준으로 하세요 — imsend-v1.yaml 내려받기

2026-09-23 — 수신거부 변경 조회 · 발송 멱등 · 배치 결과 · 충전 세션

기존 API 호출은 그대로 동작합니다. 바뀐 동작은 기존 충전 화면(가상계좌 선택지 제거·폐지 예고)뿐입니다. 새 기능을 쓰려면 아래 절을 확인하세요.

• 신규 GET /api/v1/optout 수신거부 상태 변경 이벤트(커서, 180일 보존·만료 시 410 CURSOR_EXPIRED) · GET /api/v1/optout/snapshot 현재 차단 전체 — SMS API › 수신거부 변경 조회
• 신규 /api/v1/sms/send 의 선택 필드 clientRequestId: 같은 값으로 다시 보내면 완료된 요청은 새로 발송하지 않고 처음 응답을 돌려줍니다(idempotentReplay). 처리 중이면 503 IN_PROGRESS, 선점 후 10분이 지나도 완료 기록이 없으면(적재 0 확정) 같은 키로 새로 발송합니다. 키가 있는 요청은 수신자 1,000명까지입니다 — SMS API › 멱등 키
• 신규 GET /api/v1/sms/batch/{batchId}/results 건별 결과: 상태는 등록(예약 발송은 예약) 시각 72시간 뒤 고정(UNCONFIRMED), 실제 차감액 chargedAmount 는 같은 기준 7일 뒤 확정 — SMS API › 배치 결과
• 신규 POST /api/v1/charge/session 서버 간 충전 세션(브라우저에 API 키를 싣지 않는 충전 팝업, 선불·카드 전용) — 충전 › 충전 세션
• 폐지 예고 /charge?apiKey= 방식(응답 Deprecation 헤더). 결과 알림 postMessage 는 충전 페이지 자신의 origin 과 등록된 origin(charge.embed_origins)으로만 보냅니다('*' 제거). 충전 화면의 가상계좌 선택지 제거 — 충전 › 기존 충전 화면
• 문서 공개 리셀러(슈퍼관리자) API — 하위 가맹점 API 키·발신번호 절 추가, 대행 발송 채널(SMS·이메일·알림톡)·charge=false 조건 정정 — 리셀러 API

2026-09-23 — 080 수신거부 광고 차단 강화 · 080 번호 조회

• 동작 변경 발신자를 확인하지 못한 080 수신거부는 해소 전까지 모든 광고 SMS 에서 제외합니다(정보성 발송 무영향).
• 신규 GET /api/v1/optout/info → {optout080} 광고 문구에 넣을 무료수신거부 번호 — SMS API › 080 번호