5.2 MO

목차

• 1. MO 메시지 조회
• 2. MMS MO 컨텐츠 조회
• 3. MO 메시지 조회 (Direct)
• 4. MO 컨텐츠 생성 샘플
• 5. MMS MO 컨텐츠 조회 (Direct)
• Appendix

1. MO 메시지 조회

고객이 발신한 MO(Mobile Originated) 메시지를 조회합니다. SMS, MMS 등 다양한 유형의 메시지를 조회할 수 있습니다.

📌 주의사항

1. MO 메시지는 최대 7일간 보관되며, 이후에는 자동으로 삭제됩니다.
2. MMS 메시지의 경우 contentInfoLst에 컨텐츠 정보가 포함되며, 실제 컨텐츠는 별도 API를 통해 조회해야 합니다.
3. moType에 따라 메시지 형식이 다르게 표시됩니다:
   • SMSMO: 일반 SMS 메시지
   • MMSMO: MMS 메시지
   • RCSMO: RCS 메시지

---

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/mo/v1/msg HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data[].moKey	String	MO 메시지 고유 키
data[].moNumber	String	수신번호
data[].moType	String	메시지 유형
data[].moCallback	String	발신번호
data[].productCode	String	상품 코드
data[].moTitle	String	메시지 제목 (MMS/RCS)
data[].moMsg	String	메시지 내용
data[].telco	String	이통사
data[].contentCnt	Integer	컨텐츠 개수
data[].contentInfoLst[].contentName	String	컨텐츠 파일명
data[].contentInfoLst[].contentSize	String	컨텐츠 크기
data[].contentInfoLst[].contentExt	String	컨텐츠 확장자
data[].contentInfoLst[].contentUrl	String	컨텐츠 URL
data[].moRecvDt	String	수신 일시

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/mo/v1/msg" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "moKey": "1234",
      "moNumber": "15445367",
      "moType": "SMSMO",
      "moCallback": "01012345678",
      "productCode": "",
      "moTitle": "테스트",
      "moMsg": "테스트",
      "telco": "LGU",
      "contentCnt": 1,
      "contentInfoLst": [
        {
          "contentName": "",
          "contentSize": "",
          "contentExt": "",
          "contentUrl": ""
        }
      ],
      "moRecvDt": "2024-01-29T09:22:55"
    }
  ]
}

---

2. MMS MO 컨텐츠 조회

MMS MO 메시지에 첨부된 컨텐츠를 조회합니다. 이미지, 동영상 등 다양한 형식의 컨텐츠를 조회할 수 있습니다.

📌 주의사항

1. 컨텐츠는 최대 7일간 보관되며, 이후에는 자동으로 삭제됩니다.
2. 컨텐츠 URL은 일회성이며, 24시간 이내에만 유효합니다.
3. 컨텐츠 크기가 큰 경우 다운로드에 시간이 걸릴 수 있습니다.

---

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/mo/v1/file/{moKey} HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

---

2) 응답 (Response)

컨텐츠 파일이 직접 전송됩니다. Content-Type은 컨텐츠 형식에 따라 다르게 설정됩니다.

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/mo/v1/file/1234" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  --output mms_content.jpg

---

3. MO 메시지 조회 (Direct)

MO 메시지를 직접 조회합니다. 일반 MO 메시지 조회 API와 동일한 기능을 제공하지만, 별도의 인증 절차가 필요합니다.

📌 주의사항

1. Direct API는 별도의 인증 절차가 필요하며, 사전에 등록된 IP에서만 접근 가능합니다.
2. 일반 MO 메시지 조회 API와 동일한 데이터를 제공합니다.
3. Direct API는 더 빠른 응답 속도를 제공합니다.

---

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/mo/direct/v1/msg HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

---

2) 응답 (Response)

일반 MO 메시지 조회 API와 동일한 응답 형식을 제공합니다.

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/mo/direct/v1/msg" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

---

4. MO 컨텐츠 생성 샘플

MO 컨텐츠 생성에 대한 샘플을 제공합니다. 개발자가 MO 컨텐츠를 생성할 때 참고할 수 있는 예시를 제공합니다.

📌 주의사항

1. 이 API는 샘플 데이터만 제공하며, 실제 MO 메시지와는 무관합니다.
2. 샘플 데이터는 개발 및 테스트 목적으로만 사용해야 합니다.
3. 실제 운영 환경에서는 이 API를 사용하지 않습니다.

---

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/mo/direct/v1/mmsMoSample HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

---

2) 응답 (Response)

Response Body

필드명	타입	설명
code	String	결과 코드
message	String	결과 메시지
data	Object	샘플 데이터

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/mo/direct/v1/mmsMoSample" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

---

5. MMS MO 컨텐츠 조회 (Direct)

MMS MO 컨텐츠를 직접 조회합니다. 일반 MMS MO 컨텐츠 조회 API와 동일한 기능을 제공하지만, 별도의 인증 절차가 필요합니다.

📌 주의사항

1. Direct API는 별도의 인증 절차가 필요하며, 사전에 등록된 IP에서만 접근 가능합니다.
2. 일반 MMS MO 컨텐츠 조회 API와 동일한 데이터를 제공합니다.
3. Direct API는 더 빠른 응답 속도를 제공합니다.

---

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/mo/direct/v1/file/{moKey} HTTP/1.1

Headers

필드명	타입	필수 여부	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Path Parameters

필드명	타입	필수 여부	설명
moKey	String	●	MO 메시지 키

---

2) 응답 (Response)

컨텐츠 파일이 직접 전송됩니다. Content-Type은 컨텐츠 형식에 따라 다르게 설정됩니다.

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/mo/direct/v1/file/1234" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  --output mms_content.jpg

---

Appendix

결과 코드

• 결과 코드