About

중계사에 제공되는 이통 공통 연동 규격서입니다.

`버전 정책`

URL에 사용되는 버전은 2 depth로 한다. 예) 1.x
버그 픽스, 마이너한 업데이트는 swagger version의 3 depth를 counting함 예) 1.x.x, URL에서는 2 depth를 사용.
중요한 업데이트는 1, 2 depth를 counting함. 예) 2.x 또는 1.9
MaaP FE는 버전 업데이트를 고려하여 URL을 처리 할 수 있다

`참여자`

SKT 강정원, KT 백석문, LGU 정인정

`참고문서`

`수정이력`

1.2.0 (이미지 클릭시 동작, itmpl 상품 추가, 보안성 강화) (박기남, 20221014)

메시지내 이미지 클릭시 동작 관련 /message.body - example 업데이트
/message - productCode : 이미지 템플릿 itmpl 상품 추가
보안성 강화 관련 /message 에 agencyKey, brandKey 추가 : '23년 8월부터 필수
보안성 강화 관련 /message 의 Success response 내 reason 추가 (2022.11.10)
보안성 강화 관련 전송 URL 버전 1.2로 수정, 버전 1.1은 '23년 6월 decomm 예정 (2022.11.24)
/momsg 설명 수정: 각 통신사 MaaP FE 가 moMsgWebhookUrl 에 {SKT|KT|LGU} 추가 (2022.11.24)

1.1.9 (신규 메시징 규격, expiryOption3/4, 참고문서 추가)

/file - messagebaseId 추가 (박지범, 20220419)
/message - 신규 메시징 관련 파라미터 example 추가 (박지범, 20220419)
FileInfo - messagebaseId 추가 (박기남, 20220701)
/message.expiryOption 1 수정(3일 -> 1일), 3/4 추가 (박기남, 20220824)
/message.chupList - '세션 메시지' -> '양방향 대화방' 으로 수정 (박기남, 20221018)
/message.body - description 및 example 수정, 참고문서 추가 (박기남, 20221028)

1.1.8 (동영상 스트리밍 전송을 위한 규격 추가)

TTA iframeplayB 규격, 현재는 YouTube URL 주소만 전송 가능
/message - body, footer 에 전송 예제 추가 (고병현, 박기남 20220128)

1.1.7 (양방향 서비스 지원하는 규격으로의 개정)

양방향 서비스는 중계사 발송 관점에서 아래 3가지 시나리오의 신규 스펙이 추가 됨.

MO(mobile-originated) Message 에 대한 웹훅 스펙
MO Message 에 대한 응답으로써 세션 메시지 발송 스펙
자동 응답 메시지(autoReplyMsg)를 포함한 세션 메시지 발송 결과에 대한 웹훅 스펙

(박기남, 20210908)

/momsg 에 userLocation 추가
/message replyId 세션 유효시간 변경, ceiling 정책 삭제
/message chiplist reply/action postback data 정책 삭제
/file API usageType 발송가능기간 변경 (발송가능기간 D+365일 00:00, 파일유효기간 D+456일 00:00)
/msgstatus(webhook) 세션 메시지의 경우 설명 추가

(고병현, 20210818)

양방향 메시지 발송을 위해 replyId, chipList 필드 추가
MO Msg Webhook 스펙 추가
StatusInfo 에 autoReplyMsgId, postbackId 필드 추가
/message productCode 필드 값 chat 추가

1.1.6 (양혜림, 20200702)

/file API usageType 설명 변경 : 발송가능기간 변경 (D+1일 24:00 -> D+6일 24:00, 유효기간 변경 D+4일 24:00 -> D+9일 24:00)

1.1.5 (이재영, 20200313)

/message에 productCode 옵션으로 추가

1.1.4 (고병현, 20200226)

/message API 상세 설명 업데이트
FileInfo expiryDate 상세설명 추가
footer : 최대 길이 수정

1.1.3 (이재영, 20190925)

에러코드 관련 수정 : Error 객체 생성, StatusInfo에 error 항목 추가
header : 필수 항목으로 변경
footer : 설명 및 샘플 추가

NextAPI reference

Last updated 4 months ago