Service

배달의민족

한국, 음식실험적

Playground에서 시험 API 레퍼런스 열기

Overview

배달의민족 계정을 연결해 등록 주소 관리, 매장·커머스 탐색, 지원되는 장바구니, 결제 준비, 배민페이 주문 확정, 주문 내역·취소, 리뷰 조회 및 재주문을 사용합니다.

Status

측정하지 않음

아직 측정 데이터가 없습니다. 제공이 시작되면 이 섹션에서 가동 상태를 확인할 수 있습니다.

Setup

Auth mode: 계정 연동
Credentials: 위치 기반 작업에는 배달의민족 연결 계정과 그 계정에 등록된 address_id가 필요합니다.
Sandbox: 미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

Method	API	Path	Summary
POST	장바구니 담기	/v1/baemin/add-to-cart	메뉴 또는 상품을 장바구니에 담습니다.
POST	한그릇 메뉴 둘러보기	/v1/baemin/browse-menus	할인 한그릇(1인 메뉴) 메뉴를 둘러봅니다.
POST		/v1/baemin/cancel-order	취소 가능한 주문을 취소하거나 구조화된 후속 절차를 반환합니다.
POST		/v1/baemin/delete-address	연결 계정의 주소록 항목 하나를 제거합니다.
POST		/v1/baemin/delete-order	삭제 가능한 완료 주문을 내역에서 제거합니다.
POST		/v1/baemin/email-order-receipt	사용 가능한 주문·클레임 카드 영수증을 이메일로 전송합니다.
POST		/v1/baemin/get-cart	선택한 지원 장바구니와 정규화된 내용을 반환합니다.
POST		/v1/baemin/get-commerce-product	커머스 상품 상세와 선택형 include 섹션을 반환합니다.
POST		/v1/baemin/get-current-address	계정의 변경 가능한 현재 주소 설정을 반환합니다.
POST		/v1/baemin/get-menu	옵션 그룹이 포함된 메뉴 상세를 반환합니다.
POST		/v1/baemin/get-order	주문 상세와 선택적 상태·영수증·클레임·대체 상품 확장 정보를 반환합니다.
POST		/v1/baemin/get-order-history-filters	완료 주문용 등록 주소 또는 판매자 필터를 반환합니다.
POST		/v1/baemin/get-pickup-filter-options	선택 가능한 픽업 필터를 관리형 참조로 반환합니다.
POST		/v1/baemin/get-shop	배달·픽업 조건, 메뉴, 선택적 확장 정보와 함께 매장 상세를 반환합니다.
POST		/v1/baemin/list-addresses	즐겨찾기 주소와 일반 저장 주소를 반환합니다.
POST		/v1/baemin/list-categories	위치별 카테고리와 필터 탐색 정보를 반환합니다.
POST		/v1/baemin/list-checkout-options	주문 가능한 경로와 차단된 경로를 구조화된 사유와 함께 반환합니다.
POST		/v1/baemin/list-commerce-products	판매자 또는 카테고리 하나의 커머스 상품 페이지를 반환합니다.
POST		/v1/baemin/list-orders	food 또는 commerce 채널의 완료 또는 진행 중 주문을 조회합니다.
POST		/v1/baemin/list-pickup-shops	가까운 픽업 매장의 정규화된 페이지를 반환합니다.
POST		/v1/baemin/list-reviews	FOOD 매장·메뉴 리뷰 또는 커머스 상품 리뷰를 조회합니다.
POST		/v1/baemin/list-shops	한 카테고리의 정규화된 매장 페이지를 반환합니다.
POST		/v1/baemin/place-order	준비된 주문을 배민페이로 결제하거나 할인으로 전액 충당된 경우 주 결제 없이 확정합니다.
POST		/v1/baemin/prepare-checkout	FOOD, 한그릇, B마트 또는 배민스토어 장바구니의 결제를 준비합니다.
POST		/v1/baemin/preview-commerce-search-filters	현재 커머스 필터 선택지와 결과 수를 다시 계산합니다.
POST		/v1/baemin/reorder	과거 주문으로 장바구니를 다시 구성합니다.
POST		/v1/baemin/respond-cancellation	매장의 부분 취소 제안에 응답합니다.
POST		/v1/baemin/save-address	주소를 새로 저장하거나 수정합니다.
POST		/v1/baemin/search-addresses	배달에 사용할 도로명·지번 주소를 정규화해 찾습니다.
POST		/v1/baemin/search-commerce-products	두 커머스 영역을 함께 검색해 정규화된 상품 페이지를 반환합니다.
POST		/v1/baemin/search-pickup-shops	검색어와 일치하는 픽업 매장을 정규화해 반환합니다.
POST		/v1/baemin/search-shops	정규화된 매장 검색 결과를 페이지 정보와 함께 반환합니다.
POST		/v1/baemin/select-address	계정의 활성 배달 위치를 변경합니다.
POST		/v1/baemin/update-cart	지원되는 FOOD 또는 커머스 장바구니 상태를 변경합니다.
POST		/v1/baemin/withdraw-cancel-request	계정에 결합된 참조로 현재 취소 클레임을 철회합니다.

Related guides

sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.