레이아웃 상세 조회
Last updated
Was this helpful?
Last updated
Was this helpful?
array<object>
O
레이아웃 상세 정보 입니다.
code
string
5
O
20000000
status
integer
3
O
200
desc
string
O
layoutId
string
40
샘플 레이아웃 상세 정보 입니다.
layoutName
string
40
샘플 레이아웃 이름 입니다.
productCode
string
20
샘플 레이아웃의 메시지 상품 코드 입니다.
status
string
샘플 레이아웃의 상태를 표시합니다.
ready : 사용
pause : 사용중지
registerId
string
20
등록자 ID 입니다.
registerDate
string
등록일시 입니다.
updateDate
string
수정일시 입니다.
approvalResult
string
레이아웃 등록 상태입니다. 레이아웃은 운영자 검수 없이 자동 등록됩니다.
등록완료 : 이통3사에 정상 등록된 상태입니다.
저장 : RBC 웹에서 저장만 했을 경우 상태이며 별도 등록요청을 해야 합니다.
처리중 : 이통 3사 등록 중 에러로 인해 최종 완료가 되지 않은 상태로 수정이나 삭제가 불가능한 상태입니다.
spec
string
openrichcard
레이아웃 구조가 리치카드인지 오픈리치카드인지 구분합니다. 샘플 레이아웃은 오픈리치카드로 구성되어 있습니다.
cardType
string
64
카드 종류를 구분합니다. 레이아웃에 표시되는 카드 타입은 다음 두 가지로 제한됩니다.
format : 이통사 제공 공통포맷의 카드 타입입니다.
formatBr : 사용자가 등록한 레이아웃의 카드 타입입니다.
buttonColor
string
버튼에 지정된 컬러 값을 표시합니다. 지정된 경우 컬러 Hex 값(예,'#FFFFFF')이 표시되며, 미지정 시 빈값 입니다.
array<object>
카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다. 컴포넌트 중 headerYn = 'Y' 인 컴포넌트만 등록이 가능합니다.
array<object>
카드 내의 중간 영역으로 메시지 상품에서 지정한 개수의 컴포넌트를 지정할 수 있습니다. 컴포넌트 중 bodyYn = 'Y' 인 컴포넌트만 등록이 가능합니다. 예를 들어 LMS는 최대 6개의 컴포넌트를 지정할 수 있으며, 최대 개수 범위 내에서 각 영역별 배분할 수 있습니다.
Header 1개 지정 시 body 최대 5개
body만 지정 시 최대 6개
array<object>
카드 내의 최상위 영역으로 1개의 컴포넌트를 지정할 수 있습니다. 컴포넌트 중 footerYn = 'Y' 인 컴포넌트만 등록이 가능합니다. 현재는 footer에 사용자가 직접 지정하는 컴포넌트는 없습니다.
formattedString
object
샘플 레이아웃을 구성한 openrichcard 메시지 구조 정보 입니다. 레이아웃 등록/수정 시에는 컴포넌트를 활용하므로 formattedString 은 참조 데이터로 제공됩니다.
array<object>
템플릿의 개별 파라미터를 검수하기 위한 대상 파라미터 정보 객체입니다. 크기 관련 필드는 <=0 인 경우 체크하지 않습니다.
object
템플릿 작성에 필요한 가이드 정보를 제공하기 위하여 양식 정의 시 포함되는 정보입니다. 리치카드의 경우 messagebaseInfo에서 제공됩니다.
object
리치카드, 오픈리치카드에 포함된 content(title, description, media, button) 에 대한 검증 정책 저장을 위한 객체입니다.
index
integer
레이아웃 내 컴포넌트의 순번을 표시합니다. 등록 시에는 index를 지정하지 않으며, 배열 내 순서를 기준으로 처리됩니다.
componentId
string
40
O
지정할 컴포넌트 ID 입니다.
object
레이아웃 사용 시 컴포넌트에 적용될 수 있는 옵션입니다. 옵션 지정이 가능한 경우 표기됩니다.
leftAlign
string
left
좌측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.
left : 좌측 정렬
right : 우측 정렬
center : 중앙 정렬
rightAlign
string
right
우측 컬럼(열) 전체의 글자 정렬 위치를 설정합니다.
left : 좌측 정렬
right : 우측 정렬
center : 중앙 정렬
leftTextStyle
string
normal
좌측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.
normal : 기본 스타일
bold : bold 스타일 적용
rightTextStyle
string
normal
우측 컬럼(열)에 입력되는 글자 스타일을 지정합니다.
normal : 기본 스타일
bold : bold 스타일 적용
maxCount
integer
5
테이블의 행 개수를 지정합니다. 정의된 숫자 이외에는 지정할 수 없습니다.
5 : 5행
10 : 10행
Table / StyleTable등 테이블 컴포넌트의 옵션 정보 객체 입니다.
color
string
버튼의 색상 설정 옵션입니다. 버튼의 색상은 브랜드 정보에서 지정한 templateColor 컬러 Hex 값과 동일해야 합니다. 빈값 지정 시 기본 버튼 컬러로 적용되며, 지정된 컬러 Hex 값이 templateColor의 값과 다르면 templateColor로 강제 설정됩니다.
VButton / HButton 등 버튼 컴포넌트의 옵션 정보 객체 입니다.
ctlrViewAll
boolean
컴포넌트 단위의 viewAll(모두보기) 활성화 여부를 지정합니다.
true: 컴포넌트 viewAll(모두보기) 활성화
false: 컴포넌트 viewAll(모두보기) 비활성화
금융준법고지/일반고지 컴포넌트의 옵션 정보 객체 입니다.
param
string
20
O
검수 파라미터명. (영문, 한글, 숫자, '_' 만 사용)
isMandatory
boolean
false
필수여부. true인 경우 중계사에서 메시지 전송 요청 시 해당 필드가 없는 경우 MaaP FE에서 실패처리한다. false인 경우는 해당 필드가 없는 경우도 메시지 전송이 되도록 MaaP FE에서 적절하게 처리한다.
type
string
기술검사타입을 지정합니다.
string: 문자열 검사 대상
file: 파일 검사 대상
button: formattedString 내 button 제어 대상
layout: formattedString 내 button외 제어 대상
contentType
string
컨텐츠 유형, PolicyInfo 정책을 검사하는데 사용됩니다.
"title"
"description"
"maapfile"
"cell"
"displayText"
"url"
"etc"
"buttonName"
"visibility"
strSize
integer
글자 최대 크기, type이 string인 경우
fileSize
integer
파일 최대 크기, type이 file인 경우.
strRegx
string
65535
java regular expression, null 인경우 사용하지 않음. 예)
숫자만 : '^[0-9]*$'
영문자만 : '[a-zA-Z]*$'
한글만 : '^[가-힣]*$'
영어 & 숫자만 : '^[a-zA-Z0-9]*$'
E-Mail : '^[a-zA-Z0-9]+@[a-zA-Z0-9]+$'
휴대폰 : '^01(?:0|1|[6-9])-(?:\d{3}|\d{4})-\d{4}$'
일반전화 : '^\d{2,3}-\d{3,4}-\d{4}$'
주민등록번호 : '\d{6}-[1-4]\d{6}'
IP 주소 : '([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3}).([0-9]{1,3})'
verification
array<string>
문장 패턴 정의 (SKT향) "안녕하세요", "님 ", "원입니다."
imageWidth
integer
이미지 해상도 가로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)
imageHeight
integer
이미지 해상도 세로 크기 (지정된 크기의 이미지를 등록해야 정상 발송 가능)
couplingId
string
20
파라미터 간 함께 처리되어야 하는 경우 동일한 값을 부여 즉, 같은 값의 couplingId가 지정되는 경우 지정된 파라미터는 모두 조건을 만족해야 정상 발송 처리됨
inputText
string
65535
템플릿 등록시 사용자 입력한 원본 문장(고정부 & 변수부)을 제공합니다. 단, cell방식의 타이틀 선택형은 제공되지 않습니다.
relationId
string
param과 관계가 있는 param을 의미합니다. 주로 현재 param이 입력되지 않을 경우 메시지 상에 노출여부와 연관된 visibility에 지정된 param을 표시합니다. 메시지 발송시 이통MaaP FE에서 핸들링하는 것으로 템플릿 등록이나 메시지 발송 param과는 무관하며, 참조 용도로 제공됩니다.
maxLineCount
integer
max 라인수
maxDisplayText
integer
버튼명 글자수
maxDescriptionSize
integer
카드별 max 본문 글자수
imageWidth
integer
이미지 권고 가로 사이즈 단위는 Pixel
imageHeight
integer
이미지 권고 세로 사이즈 단위는 Pixel
detailInfo
object
리치카드 메시지 상품별 1라인당 글자수, 타이틀 라인수 및 버튼 수에 따라 메시지가 잘려 보이지 않는 최대 라인수 정보를 제공합니다. 메시지가 수신된 단말에 따라 상이할 수 있으나 리치카드 RCS메시지 발송 시 권장사항으로 참고하시기 바랍니다. LMS와 MMS 12종 총 13종에 대해 개별 제공됩니다.
buttonsAllowed
boolean
MaaP FE /message의 buttons 사용 유무 true : buttons 필드 사용 false : buttons 에 값이 들어오면 실패 처리
adHeaderAllowed
boolean
header에 광고 인입 허가 여부 true : 광고인입 허용(MaaP FE /message의 header 체크안함) false : 광고인입 불허(MaaP FE /message이 header가 1(광고) 이면 실패 처리)
adBodyAllowed
boolean
광고 문구 허용 여부 true : 본문 광고 문구를 체크하지 않음 false : 본문이 "(광고)"로 시작하면 실패 처리
cardCount
integer
카드 개수
maxTitleSize
integer
개별 타이틀 글자 최대 수. 사용하지 않음.
maxButtonCount
integer
버튼 최대 개수
maxDescriptionSize
integer
RichCard인 경우(Carousel포함) Description들의 글자수 총합. OpenRichCard인 경우 변수부 글자수 총합. <=0 인 경우 사용하지 않음.
maxMediaSize
integer
Byte단위 미디어 크기 총합의 최대 크기, <=0 인 경우 사용하지 않음.
error code는 RCS Biz Center - Response body error code 참조
브랜드 별 등록된 레이아웃 상세 내용을 조회합니다.
/brand/{brandId}/layout/{layoutId}
maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.
레이아웃ID 입니다.
maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.
대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다. 따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.