API 요청에 대한 응답은 아래의 JSON 형식을 따라야 합니다. 모든 응답은 반드시 이 형식에 맞춰서 반환되어야 하며, title
, description
, imageUrl
, buttons
필드는 내용이 없더라도 반드시 존재해야 합니다. 이 중 하나라도 누락되면 오류가 발생합니다.
objectType
: 문자열, 값은 list
로 고정입니다.contents
: 배열, 하나 이상의 Content
객체를 포함합니다.각 Content
객체는 다음과 같은 필드를 갖습니다:
title
(문자열, 선택): 콘텐츠의 제목입니다. 제목이 없는 경우 빈 문자열로 표시합니다.description
(문자열, 선택): 콘텐츠의 설명입니다. 설명이 없는 경우 빈 문자열로 표시합니다.imageUrl
(문자열, 선택): 이미지의 URL입니다. 이미지가 없는 경우 빈 문자열로 표시합니다. URL 형식이어야 합니다.link
(문자열, 선택): 콘텐츠와 연결된 링크의 URL입니다. title
을 클릭하면 이 링크로 이동합니다. 링크가 없는 경우 빈 문자열로 표시합니다. URL 형식이어야 합니다.buttons
(배열, 선택): 하나 이상의 Button
객체를 포함하는 배열입니다. 버튼이 없는 경우 빈 배열로 표시합니다.각 Button
객체는 다음과 같은 필드를 갖습니다:
name
(문자열, 필수): 버튼 내부에 표시될 텍스트 입니다.type
(문자열, 필수): 버튼의 타입으로, "nextAction"
또는 "link"
중 하나여야 합니다.type
이 "nextAction"
인 경우:
actionNumber
(문자열, 필수): 사용할 액션의 번호입니다.(현재는 사용 하지 않습니다.)name
(문자열, 필수): 버튼의 이름입니다.url
필드는 포함하지 않습니다.