개요

주문 엔드 투 엔드 데이터 피드의 구조는 관계형 인벤토리 스키마에 의해 정의됩니다. 주문 엔드 투 엔드 데이터 피드는 다음과 같은 최상위 항목으로 구성됩니다.

다음 다이어그램은 Service, Restaurant, Menu 항목이 단일 레스토랑을 나타내는 방식을 보여줍니다.

레스토랑 서비스 메뉴 클래스 관계 다이어그램
그림 1: 주문 엔드 투 엔드 데이터 피드 항목(서비스, 레스토랑, 메뉴)의 전반적인 관계

일반 가이드라인

  • 파일당 레스토랑: 각 데이터 파일은 관련 ServiceMenu 항목과 함께 하나의 레스토랑을 나타내야 합니다. 레스토랑 파일을 검색하는 데 도움이 되는 파일 이름을 사용하세요.

  • 데이터 파일 형식: 데이터 파일은 줄바꿈으로 구분된 JSON 파일 (ndjson 형식) 형식이어야 합니다.

  • 날짜/시간 및 시간 값: DateTime 또는 Time 값이 필요한 속성의 경우 날짜/시간 및 시간 형식에 지정된 형식을 사용합니다. 예: DateTime의 경우 2017-05-01T06:30:00+05:30, Time의 경우 T08:08:00+05:30

  • ID: @id 속성을 사용하여 항목 유형 내의 모든 고유 항목을 식별합니다. 최대 길이는 300자(영문 기준)입니다. @id는 해당 유형의 항목의 고유 식별자이지만 항목 간에 ID가 겹칠 수 있습니다. 예를 들어 @id 속성을 a16로 설정하여 Service 항목을 정의한다고 가정해 보겠습니다. @ida16인 다른 Service 항목을 만들 수 없습니다. 하지만 a16Menu 항목의 @id 값으로 사용할 수 있습니다.

  • ID 생성: ID를 안정적으로 유지합니다. UUID를 사용하거나 피드 업로드 간에 ID를 변경/무작위로 생성하지 마세요. 이렇게 하면 항목 관련 문제를 더 쉽게 지원할 수 있습니다.

  • null 값: 객체 대신 null 값을 사용하지 마세요. 객체가 선택사항인 경우 피드에서 생략해야 합니다.

클라이언트 라이브러리

Tools 섹션의 클라이언트 코드 생성기를 사용하여 주문 엔드 투 엔드 데이터 피드의 유효성을 검사할 수 있습니다.