### Query Warning List - API Request Example Source: https://developer.waimai.meituan.com/home/docDetail/913 This snippet demonstrates how to make a GET request to the Meituan Waimai Open API to retrieve a list of warnings. It includes the base URL and query parameters for pagination and sorting. Ensure you have the correct authentication headers if required by the API. ```http GET https://waimaiopen.meituan.com/gw/govern/open/warning/list/query?pageSize=1&pageNum=10 ``` -------------------------------- ### Get Poi Tag List (JSON Example) Source: https://developer.waimai.meituan.com/home/docDetail/28 Example of a successful response from the poiTag/list API, returning a list of store categories with their IDs and names. This data is used to reference category information when updating store details. ```json { "data": [{"id": 1, "name": "中餐"}], "code": 0, "msg": "ok" } ``` -------------------------------- ### Query Violation Statistics (GET Request Example) Source: https://developer.waimai.meituan.com/home/docDetail/914 This snippet demonstrates how to make a GET request to the Meituan Waimai Open API to query violation statistics. It includes the base URL and example parameters for specifying a time range. The response will contain detailed counts of various violation and warning types. ```http GET https://waimaiopen.meituan.com/gw/govern/open/violation/statistics/query?startTime=1678886400000&endTime=1678972800000 ``` -------------------------------- ### GET /gw/govern/open/warning/list/query Source: https://developer.waimai.meituan.com/home/docDetail/913 Retrieves a list of warning orders with pagination and sorting capabilities. ```APIDOC ## GET /gw/govern/open/warning/list/query ### Description Retrieves a list of warning orders. Supports pagination and sorting. ### Method GET ### Endpoint https://waimaiopen.meituan.com/gw/govern/open/warning/list/query ### Parameters #### Query Parameters - **pageSize** (Integer) - Required - Number of items per page. - **pageNum** (Integer) - Required - The current page number. - **sortField** (String) - Optional - The field to sort by. - **sortOrder** (String) - Optional - The order of sorting (e.g., 'asc', 'desc'). ### Request Example ```json { "pageSize": 10, "pageNum": 1, "sortField": "notificationTime", "sortOrder": "desc" } ``` ### Response #### Success Response (200) - **code** (int) - Return code (0 for success, -1 for failure). - **message** (String) - Return message. - **data** (Object) - Contains the list of warning orders and pagination details. - **list** (Array) - Array of warning order objects. - **total** (Integer) - Total number of warning orders. - **unreadTotal** (Integer) - Total number of unread warning orders. - **pageSize** (Integer) - Number of items per page. - **pageNum** (Integer) - Current page number. #### Response Example ```json { "code": 0, "msg": null, "data": { "list": [ { "warningId": "6368371350378851", "newWarningId": "6368371350378851", "warningViewId": "6368371350378851", "firstScene": "1级场景标题", "secondScene": "QA自动化开单场景", "thirdScene": "health常规自动化开单", "violationScene": "自动化开单-门店预警单-health", "ruleId": 40028, "readStatus": 1, "bizOrgCode": 14010, "poiId": 1825898, "poiName": "health祖传烤鸡店", "warningReason": "自动化开单", "ruleDesc": "自动化开单-门店预警单-health", "notificationTime": 1767564517000, "calStartTime": 1767564517000, "calEndTime": 1767564517000, "productSnapshot": null, "extra": { "ruleSubType": 0, "correctDeadline": "0天0小时" } } ], "total": 2, "unreadTotal": 1, "pageSize": 2, "pageNum": 1 } } ``` #### Error Response Example ```json { "code": -1, "data": null, "message": "查询预警单详情失败" } ``` ### Error Codes | Error Code | Error Message | Solution | |---|---|---| | | | | ``` -------------------------------- ### GET /api/v1/poi/weight/canOpen Source: https://developer.waimai.meituan.com/home/docDetail/284 Queries whether a store can be enabled for weighting and provides the reason if it cannot be enabled. ```APIDOC ## GET /api/v1/poi/weight/canOpen ### Description Queries whether a store can be enabled for weighting and provides the reason if it cannot be enabled. ### Method GET ### Endpoint https://waimaiopen.meituan.com/api/v1/poi/weight/canOpen ### Parameters #### Query Parameters - **app_poi_code** (string) - Required - APP side store ID ### Response #### Success Response (200) - **data** (list) - Contains weighting status information. - **canWeight** (boolean) - Indicates if weighting can be enabled. - **openWeightStatus** (integer) - The status code for opening weighting. - **overDueDate** (string) - The date and time when the current weighting period expires. - **weightStartTime** (integer) - The timestamp when the weighting started. - **surPlusTime** (integer) - The remaining time in seconds for the current weighting period. - **unPassHardThresholdResults** (null) - Results for failing hard thresholds (currently null). - **unPassSoftThresholdResults** (null) - Results for failing soft thresholds (currently null). #### Response Example ```json { "data": { "canWeight": true, "openWeightStatus": 1, "overDueDate": "2018-02-19 11:26:06", "weightStartTime": 1534717631, "surPlusTime": 3600, "unPassHardThresholdResults": null, "unPassSoftThresholdResults": null } } ``` ``` -------------------------------- ### GET /wm/bill/list Source: https://developer.waimai.meituan.com/home/docDetail/326 Retrieves the daily bill for a specified date range. Note that bills for the previous day can only be queried before 10 AM. The date range cannot exceed 7 days. ```APIDOC ## GET /wm/bill/list ### Description Retrieves the daily bill for a specified date range. Note that bills for the previous day can only be queried before 10 AM. The date range cannot exceed 7 days. ### Method GET ### Endpoint https://waimaiopen.meituan.com/api/v1/wm/bill/list ### Parameters #### Query Parameters - **app_poi_code** (string) - Required - APP方门店id - **start_date** (integer) - Required - 开始日期 (Unix timestamp) - **end_date** (integer) - Required - 结束日期 (Unix timestamp) - **offset** (integer) - Required - 分页查询偏移量 - **limit** (integer) - Required - 分页查询每页的数量,须小于等于200 ### Request Example ```json { "app_poi_code": "25381", "start_date": 1528301487, "end_date": 1528387887, "offset": 0, "limit": 10 } ``` ### Response #### Success Response (200) - **wmPoiName** (string) - 门店名称 - **billChargeType** (int) - 交易类型 - **chargeFeeDesc** (string) - 交易描述 - **userPayType** (int) - 用户支付方式 (-1-未知;1-货到付款;2-在线支付) - **wmPoiOrderPushDayseq** (string) - 订单序号 - **wmOrderViewid** (string) - 订单展示ID - **orderTime** (string) - 下单时间 - **finishTime** (string) - 完成时间 - **refundTime** (string) - 退款时间 - **orderState** (int) - 订单状态 (1-订单已提交,等待商家确认;2-已退单,等待商家确认;3-商家已收到订单,等待商家确认;4-商家已确认订单,订单已处理;5-订单分配中,订单正在分配;6-配送中,订单配送中;7-已送达,订单已被送达;8-已完成,订单完成;9-已取消,订单取消) - **shippingType** (int) - 配送方式 (10-商家自配;20-美团快送;30-美团跑腿;40-美团专送;50-代理商配送;60-到店取餐;120-企客远距离配送) - **shippingStatus** (int) - 配送状态 (0-未知;1-已推单;10-已抢单;15-已取餐;20-派送中;40-已送达;100-已取消) - **accountState** (int) - 结算状态 (0-已入账;1-未入账) - **daliyBillDate** (string) - 账单日期 - **settleBillDesc** (string) - 归账日期 - **settleAmount** (long) - 商家应收款(分) - **totalFoodAmount** (long) - 商品总价(商品总价=菜品原价+赠品原价)(分) - **boxAmount** (long) - 餐盒费(分) - **activityPoiAmount** (long) - 商家活动支出(分) - **activityMeituanAmount** (long) - 美团活动补贴(分) - **platformChargeFee** (long) - 平台服务费(分) - **userPayShippingAmount** (long) - 用户支付配送费(分) - **userOnlinePayAmount** (long) - 用户线上支付金额(分) - **userOfflinePayAmount** (long) - 用户线下支付金额(分) - **rate** (long) - 费率(分) - **bottom** (long) - 保底(分) - **discount** (int) - 分成折扣 - **settleMilli** (long) - 结算金额,以毫为单位 - **settleSettingId** (string) - 结算id,表示账期等信息的结算设置id - **wmDonationAmount** (long) - 青山计划-公益捐赠金额 - **wmDoggyBagAmount** (long) - 商超-打包袋金额 - **dealTip** (long) - 配送小费(分) - **wmOpenBillExtra** (object) - 补充信息 - **rateNew** (double) - 费率,含义同rate字段,无精度损失 - **originCommission** (long) - 商品总佣金 - **deductionCommission** (long) - 佣金优惠金额(分) - **deductionCommissionDetail** (String) - 佣金优惠明细(分) - **agreeChargeFeeMax** (long) - 履约服务费封顶值(分) - **deductionCommissionDiscount** (double) - 营销活动佣金折扣 - **activityAgentAmount** (long) - 代理商活动补贴金额(分) - **sqsAfterDisountAmount** (long) - 神抢手商品优惠后金额(分) - **sqsCommissionRateStr** (string) - 神抢手商品服务费率 - **activityCouponSellPoiAmount** (double) - 商家券-美团补贴金额(元) - **poiChargeFee** (double) - 商家券-商家补贴金额(元) - **userChargeFee** (double) - 商家券(含神抢手券包)-用户支付金额(元) - **mtSubsidyMinusUserFee** (long) - 美团活动补贴(分)(去除商家券-用户支付金额) - **droneAirportUsageFee** (long) - 无人机机场使用费 - **droneCloudPlatformServiceFee** (long) - 无人机云平台服务费 - **accountSettleId** (String) - 入账结算id #### Response Example ```json { "wmPoiName": "Example Store", "billChargeType": 1, "chargeFeeDesc": "Order charge", "userPayType": 2, "wmPoiOrderPushDayseq": "12345", "wmOrderViewid": "VIEWID67890", "orderTime": "2023-10-27 10:00:00", "finishTime": "2023-10-27 10:30:00", "refundTime": null, "orderState": 8, "shippingType": 20, "shippingStatus": 40, "accountState": 0, "daliyBillDate": "2023-10-27", "settleBillDesc": "Settled", "settleAmount": 15000, "totalFoodAmount": 12000, "boxAmount": 500, "activityPoiAmount": 1000, "activityMeituanAmount": 2000, "platformChargeFee": 300, "userPayShippingAmount": 1000, "userOnlinePayAmount": 13000, "userOfflinePayAmount": 0, "rate": 150, "bottom": 0, "discount": 10, "settleMilli": 15000, "settleSettingId": "SETID123", "wmDonationAmount": 0, "wmDoggyBagAmount": 0, "dealTip": 50, "wmOpenBillExtra": { "rateNew": 0.015, "originCommission": 1200, "deductionCommission": 120, "deductionCommissionDetail": "-120", "agreeChargeFeeMax": 10000, "deductionCommissionDiscount": 0.9, "activityAgentAmount": 0, "sqsAfterDisountAmount": 0, "sqsCommissionRateStr": "", "activityCouponSellPoiAmount": 0.0, "poiChargeFee": 0.0, "userChargeFee": 0.0, "mtSubsidyMinusUserFee": 0, "droneAirportUsageFee": 0, "droneCloudPlatformServiceFee": 0, "accountSettleId": "1223422" } } ``` ### Error Handling - **400 Bad Request**: Invalid parameters provided. - **401 Unauthorized**: Authentication failed. - **500 Internal Server Error**: Server error. ``` -------------------------------- ### Update Store Announcement - POST Request Example Source: https://developer.waimai.meituan.com/home/docDetail/25 This snippet demonstrates how to make a POST request to the poi/updatepromoteinfo endpoint to update a store's announcement. It requires the app_poi_code and optionally accepts promotion_info. The response indicates success or failure. ```http POST https://waimaiopen.meituan.com/api/v1/poi/updatepromoteinfo Content-Type: application/json { "app_poi_code": "12233", "promotion_info": "门店公告内容" } ``` -------------------------------- ### Callback API Troubleshooting Source: https://developer.waimai.meituan.com/home/questionDetail/13458 This section details common problems and solutions when configuring callback interfaces, including requirements for URL accessibility, supported HTTP methods, and port configurations. ```APIDOC ## Callback API Troubleshooting Guide ### Description This guide addresses common issues encountered when setting up callback interfaces, such as legality timeouts and inaccessibility. It provides specific requirements and troubleshooting steps to ensure your callback URLs are correctly configured and accessible by the Meituan platform. ### Method N/A (Informational Guide) ### Endpoint N/A (Informational Guide) ### Parameters N/A (Informational Guide) ### Request Example N/A (Informational Guide) ### Response #### Success Response (200) N/A (Informational Guide) #### Response Example N/A (Informational Guide) ### Troubleshooting Steps: 1. **Interface Accessibility**: Ensure your callback interface supports both **GET** and **POST** requests. The platform performs two checks: * A security check using **GET**. * A second check using the actual required method (**POST** or **GET**, as specified in the relevant API documentation). 2. **URL and Port Requirements**: * For **HTTP** URLs, only ports **80** or **8080** are supported. * For **HTTPS** URLs, only port **443** is supported. 3. **External Network Access and Response Time**: * Your URL must be accessible from the **external network**. * The interface must respond correctly within the time limits specified in the API documentation. * The response to Meituan's heartbeat detection requests (with empty parameters) should have an HTTP status code of **200**. ``` -------------------------------- ### POST /gw/mop/diancannew/shop/queryShops Source: https://developer.waimai.meituan.com/home/docDetail/879 Queries shop configuration information. This endpoint is used for shop information reconciliation. ```APIDOC ## POST /gw/mop/diancannew/shop/queryShops ### Description Queries shop configuration information, used for shop information reconciliation. ### Method POST ### Endpoint https://waimaiopen.meituan.com/gw/mop/diancannew/shop/queryShops ### Parameters #### Query Parameters - **app_poi_codes** (String) - Required - A comma-separated list of vendor shop IDs (e.g., 123,300). The batch request limit is 20. ### Request Body (No specific request body schema provided, but typically includes parameters like `app_poi_codes`) ### Response #### Success Response (200) - **data** (Object) - A list of vendor shop configuration information. If 10 IDs are queried and 9 are found, the list will contain 9 `VendorShopConfigDTO` objects and 1 `failMsg`. - **code** (int) - The response code. - **msg** (string) - The response message. #### Response Example (No example provided) #### Error Codes (No specific error codes provided in the documentation) ``` -------------------------------- ### Get Poi Tag List Error Response (JSON Example) Source: https://developer.waimai.meituan.com/home/docDetail/28 Example of an error response from the poiTag/list API, indicating a system error with a specific error code and message. This helps developers understand and handle potential issues when fetching store categories. ```json { "data": "ng", "error": { "code": 1, "msg": "系统错误" } } ``` -------------------------------- ### Store Configuration and Governance Source: https://developer.waimai.meituan.com/home/doc/food/1 APIs for querying store configurations, and managing violations and warnings. ```APIDOC ## POST /gw/mop/diancannew/shop/queryShops ### Description Queries store configurations. ### Method POST ### Endpoint /gw/mop/diancannew/shop/queryShops ### Parameters #### Request Body - **query_params** (object) - Optional - Parameters for querying shops. - **shop_ids** (array) - Optional - List of shop IDs to query. ### Request Example ```json { "query_params": { "shop_ids": ["store1", "store2"] } } ``` ### Response #### Success Response (200) - **shops** (array) - A list of shop configuration objects. #### Response Example ```json { "shops": [ { "shop_id": "store1", "config": { "delivery_time": 30 } } ] } ``` --- ## POST /gw/govern/open/violation/list/query ### Description Queries a list of violations. ### Method POST ### Endpoint /gw/govern/open/violation/list/query ### Parameters #### Request Body - **query_params** (object) - Optional - Parameters for querying violations. - **shop_id** (string) - Optional - Filter by shop ID. - **start_time** (string) - Optional - Start of the time range (YYYY-MM-DD). - **end_time** (string) - Optional - End of the time range (YYYY-MM-DD). ### Request Example ```json { "query_params": { "shop_id": "store1", "start_time": "2023-10-01", "end_time": "2023-10-27" } } ``` ### Response #### Success Response (200) - **violations** (array) - A list of violation objects. #### Response Example ```json { "violations": [ { "violation_id": "v1", "shop_id": "store1", "reason": "Late delivery" } ] } ``` --- ## POST /gw/govern/open/warning/list/query ### Description Queries a list of warnings. ### Method POST ### Endpoint /gw/govern/open/warning/list/query ### Parameters #### Request Body - **query_params** (object) - Optional - Parameters for querying warnings. - **shop_id** (string) - Optional - Filter by shop ID. - **start_time** (string) - Optional - Start of the time range (YYYY-MM-DD). - **end_time** (string) - Optional - End of the time range (YYYY-MM-DD). ### Request Example ```json { "query_params": { "shop_id": "store1", "start_time": "2023-10-01", "end_time": "2023-10-27" } } ``` ### Response #### Success Response (200) - **warnings** (array) - A list of warning objects. #### Response Example ```json { "warnings": [ { "warning_id": "w1", "shop_id": "store1", "reason": "Low rating" } ] } ``` --- ## POST /gw/govern/open/violation/statistics/query ### Description Queries the statistics of violations. ### Method POST ### Endpoint /gw/govern/open/violation/statistics/query ### Parameters #### Request Body - **query_params** (object) - Optional - Parameters for querying violation statistics. - **shop_id** (string) - Optional - Filter by shop ID. - **start_time** (string) - Optional - Start of the time range (YYYY-MM-DD). - **end_time** (string) - Optional - End of the time range (YYYY-MM-DD). ### Request Example ```json { "query_params": { "shop_id": "store1", "start_time": "2023-10-01", "end_time": "2023-10-27" } } ``` ### Response #### Success Response (200) - **statistics** (object) - Violation statistics. #### Response Example ```json { "statistics": { "total_violations": 5, "types": { "late_delivery": 3, "order_cancellation": 2 } } } ``` --- ## POST /gw/govern/open/violation/detail/query ### Description Queries the details of a violation. ### Method POST ### Endpoint /gw/govern/open/violation/detail/query ### Parameters #### Request Body - **violation_id** (string) - Required - The ID of the violation. ### Request Example ```json { "violation_id": "v1" } ``` ### Response #### Success Response (200) - **violation_details** (object) - Detailed information about the violation. #### Response Example ```json { "violation_details": { "violation_id": "v1", "shop_id": "store1", "reason": "Late delivery", "timestamp": "2023-10-26T10:00:00Z" } } ``` --- ## POST /gw/govern/open/warning/detail/query ### Description Queries the details of a warning. ### Method POST ### Endpoint /gw/govern/open/warning/detail/query ### Parameters #### Request Body - **warning_id** (string) - Required - The ID of the warning. ### Request Example ```json { "warning_id": "w1" } ``` ### Response #### Success Response (200) - **warning_details** (object) - Detailed information about the warning. #### Response Example ```json { "warning_details": { "warning_id": "w1", "shop_id": "store1", "reason": "Low rating", "timestamp": "2023-10-25T15:30:00Z" } } ``` --- ## POST /gw/govern/open/violation/score/record/r/query ### Description Queries the record of violation points. ### Method POST ### Endpoint /gw/govern/open/violation/score/record/r/query ### Parameters #### Request Body - **query_params** (object) - Optional - Parameters for querying score records. - **shop_id** (string) - Optional - Filter by shop ID. - **start_time** (string) - Optional - Start of the time range (YYYY-MM-DD). - **end_time** (string) - Optional - End of the time range (YYYY-MM-DD). ### Request Example ```json { "query_params": { "shop_id": "store1", "start_time": "2023-10-01", "end_time": "2023-10-27" } } ``` ### Response #### Success Response (200) - **score_records** (array) - A list of violation score record objects. #### Response Example ```json { "score_records": [ { "record_id": "sr1", "shop_id": "store1", "points": -1, "reason": "Late delivery", "timestamp": "2023-10-26T10:00:00Z" } ] } ``` --- ## POST /gw/govern/open/violation/score/r/query ### Description Queries the violation points for a store. ### Method POST ### Endpoint /gw/govern/open/violation/score/r/query ### Parameters #### Request Body - **query_params** (object) - Optional - Parameters for querying violation scores. - **shop_id** (string) - Optional - Filter by shop ID. - **start_time** (string) - Optional - Start of the time range (YYYY-MM-DD). - **end_time** (string) - Optional - End of the time range (YYYY-MM-DD). ### Request Example ```json { "query_params": { "shop_id": "store1", "start_time": "2023-10-01", "end_time": "2023-10-27" } } ``` ### Response #### Success Response (200) - **violation_scores** (object) - Violation score information. #### Response Example ```json { "violation_scores": { "shop_id": "store1", "total_points": -5 } } ``` --- ## POST /gw/govern/open/appeal/detail/query ### Description Queries the details of an appeal. ### Method POST ### Endpoint /gw/govern/open/appeal/detail/query ### Parameters #### Request Body - **appeal_id** (string) - Required - The ID of the appeal. ### Request Example ```json { "appeal_id": "a1" } ``` ### Response #### Success Response (200) - **appeal_details** (object) - Detailed information about the appeal. #### Response Example ```json { "appeal_details": { "appeal_id": "a1", "violation_id": "v1", "status": "pending", "submitted_at": "2023-10-27T09:00:00Z" } } ``` ``` -------------------------------- ### Get Store IDs (poi/getids) - Success Response Example Source: https://developer.waimai.meituan.com/home/docDetail/4 This code snippet demonstrates a successful response from the poi/getids API endpoint. It returns a JSON object containing a status code (0 for success), an empty message, and a list of store IDs (app_poi_code). ```json { "code": 0, "msg": "", "data": [ "123", "456" ] } ``` -------------------------------- ### POST /gw/mop/synDealMapping Source: https://developer.waimai.meituan.com/home/docDetail/874 Synchronizes group-buy deal and product relationships to Meituan. This endpoint is used by vendors to update the mapping between deals and specific dishes. ```APIDOC ## POST /gw/mop/synDealMapping ### Description This endpoint allows vendors to synchronize group-buy deal and product mappings with Meituan. It is crucial for ensuring that the correct dishes are associated with promotional deals. ### Method POST ### Endpoint https://waimaiopen.meituan.com/gw/mop/synDealMapping ### Parameters #### Path Parameters None #### Query Parameters None #### Request Body - **app_id** (int) - Required - The application ID provided by Meituan. - **sig** (string) - Required - The signature for the request, consistent with the Meituan Waimai integration. - **requestData** (DealMappingInfo) - Required - An object containing the group-buy deal and product mapping information. ### Request Example ```json { "app_id": 12345, "sig": "your_signature", "requestData": { "deal_id": "deal123", "product_ids": ["prodA", "prodB"] } } ``` ### Response #### Success Response (200) - **code** (String) - The response status code. 'OP_SUCCESS' indicates success. - **msg** (String) - A message describing the outcome of the request. - **traceId** (String) - A unique identifier for the request. - **data** (Object) - Business data. If the request fails, this may contain detailed error information. #### Response Example ```json { "code": "OP_SUCCESS", "msg": "Success", "traceId": "7457794513993866186", "data": {} } ``` #### Error Response Example ```json { "code": "AUTH_FAILED", "msg": "Authentication Failed", "traceId": "some_trace_id", "data": { "error_details": "Invalid credentials provided." } } ``` ``` -------------------------------- ### POST /websites/developer_waimai_meituan_home Source: https://developer.waimai.meituan.com/home/docDetail/878 Queries the estimated food preparation time and queueing information for stores. This is a mandatory endpoint for app integration. ```APIDOC ## POST /websites/developer_waimai_meituan_home ### Description This endpoint allows you to query the estimated food preparation time and queueing information for stores. It is a mandatory endpoint for app integration. ### Method POST ### Endpoint /websites/developer_waimai_meituan_home ### Parameters #### Request Body - **requestData** (Object) - Required - A list of store codes for which to query information. Example: `{"app_poi_codes":["11111"]}` ### Response #### Success Response (200) - **code** (Integer) - Response code, 0 for success, others for failure. - **data** (Object) - Estimated waiting information, including waiting cups and estimated pickup time. Example: `[{"predicatedMinMinutes":5,"predicatedMaxMinutes":5,"predicatedCount":10,"app_poi_code":"11111"}]` - **msg** (String) - Prompt message. - **success** (Boolean) - Result status. #### Response Example ```json { "code": 0, "data": [ { "predicatedMinMinutes": 5, "predicatedMaxMinutes": 5, "predicatedCount": 10, "app_poi_code": "11111" } ], "msg": "Success", "success": true } ``` ``` -------------------------------- ### POST /api/v1/poi/save Source: https://developer.waimai.meituan.com/home/docDetail/792 This endpoint allows for the batch upload of product videos for a Point of Interest (POI). It does not have any application-level parameters. ```APIDOC ## POST /api/v1/poi/save ### Description Allows for the batch upload of product videos associated with a Point of Interest (POI). ### Method POST ### Endpoint /api/v1/poi/save ### Parameters #### Path Parameters None #### Query Parameters None #### Request Body This endpoint does not define specific application-level parameters for the request body. System-level parameters may apply. ### Request Example ```json { "example": "No request example provided" } ``` ### Response #### Success Response (200) Details of the success response parameters are not explicitly defined in the provided documentation. #### Response Example ```json { "example": "200" } ``` #### Error Response (503) Details of the error response parameters are not explicitly defined in the provided documentation. #### Error Code Explanation | Error Code | Error Message | Solution | |---|---|---| | | | | ``` -------------------------------- ### Set Poi To Open State (JSON Example) Source: https://developer.waimai.meituan.com/home/docDetail/347 Example of a successful JSON response when setting a POI to an open state. This indicates the operation was successful. ```json {"data":"ok"} ``` -------------------------------- ### Failure Response Example Source: https://developer.waimai.meituan.com/home/docDetail/13 This example illustrates a failure response from the Meituan Waimai API, typically when the specified store does not exist. It includes an error code and a descriptive message. ```json { "code": 803, "msg": "不存在此门店" } ``` -------------------------------- ### Batch Get Store Details (HTTP GET) Source: https://developer.waimai.meituan.com/home/docDetail/7 This snippet demonstrates how to make an HTTP GET request to the poi/mget endpoint to retrieve detailed information for multiple stores. It requires the `app_poi_codes` parameter, which is a comma-separated string of Meituan-assigned store IDs. The response includes various details about each store, such as name, address, contact information, operating hours, and more. Error responses will contain an `error` object with a `code` and `msg`. ```HTTP GET https://waimaiopen.meituan.com/api/v1/poi/mget?app_poi_codes=12233,45678 ``` -------------------------------- ### Store Weighting Management Source: https://developer.waimai.meituan.com/home/doc/food/1 APIs for managing store weighting, including checking eligibility and enabling it. ```APIDOC ## POST /poi/weight/canOpen ### Description Checks if a store can be opened with weighting. ### Method POST ### Endpoint /poi/weight/canOpen ### Parameters #### Request Body - **poi_id** (string) - Required - The ID of the store. ### Request Example ```json { "poi_id": "store1" } ``` ### Response #### Success Response (200) - **can_open** (boolean) - True if the store can be opened with weighting, false otherwise. #### Response Example ```json { "can_open": true } ``` --- ## POST /poi/weight/open ### Description Enables weighting for a store. ### Method POST ### Endpoint /poi/weight/open ### Parameters #### Request Body - **poi_id** (string) - Required - The ID of the store. ### Request Example ```json { "poi_id": "store1" } ``` ### Response #### Success Response (200) - **status** (string) - Indicates the success or failure of the operation. #### Response Example ```json { "status": "success" } ``` ``` -------------------------------- ### Meituan Waimai Appeal Detail Query API Failure Example Source: https://developer.waimai.meituan.com/home/docDetail/919 Example of a failed response from the Meituan Waimai appeal detail query API. It indicates an error with a specific code and message. ```json { "code":-1, "data":null, "message":"查询申诉详情失败" } ``` -------------------------------- ### Meituan Waimai Appeal Detail Query API Example Source: https://developer.waimai.meituan.com/home/docDetail/919 Example of a successful response from the Meituan Waimai appeal detail query API. It includes the appeal status, details of the last appeal record, and history. ```json { "code": 0, "data": { "violationTicketId": "6368371355371772", "appealTicketId": "6368371349407786", "poiId": 1825898, "lastAppealRecord": { "status": 30, "statusDesc": "申诉成功", "ctime": 1765366313000, "reason": null, "phone": "", "content": "123123123123123字的发啥发的发阿道夫啊啥的啊啥的啥发的发啥地方手段发", "mediaList": [], "auditDescription": "经审核,您的申诉已通过,处置已撤销" }, "historyAppealRecordList": null, "status": 30, "statusDesc": "申诉成功" }, "message": null } ``` -------------------------------- ### POST /gw/mop/diancannew/shop/serve/status/update Source: https://developer.waimai.meituan.com/home/docDetail/873 Allows brand owners to update the operational hours and status of their shops in a batch. ```APIDOC ## POST /gw/mop/diancannew/shop/serve/status/update ### Description This endpoint allows brand owners to update the operational hours and status of their shops in a batch. It supports updating up to 20 shops per request. ### Method POST ### Endpoint https://waimaiopen.meituan.com/gw/mop/diancannew/shop/serve/status/update ### Parameters #### Request Body - **requestData** (List) - Required - Vendor configuration list, with a batch limit of 20 per request. - **app_id** (int) - Required - The application ID. - **sig** (String) - Required - Signature from the cooperation center, consistent with Waimai integration. - **app_poi_codes** (String) - Required - A comma-separated list of vendor shop IDs (e.g., "123,300"). ### Request Example ```json { "requestData": [ { "app_id": 12345, "sig": "a_valid_signature", "app_poi_codes": "1001,1002", "vendorServiceConfigRequest": { "open_time": "09:00", "close_time": "22:00", "serve_status": 1 } } ] } ``` ### Response #### Success Response (200) - **data** (Map) - A map where the key is the shop ID and the value is the operation result. - **OperateResult** (object) - Contains the result of the operation for a specific shop. - **code** (int) - Operation result code. - **message** (String) - Description of the operation result. #### Response Example ```json { "data": { "1001": { "code": 0, "message": "Success" }, "1002": { "code": 1001, "message": "Shop not found" } } } ``` #### Error Codes (No specific error codes or solutions provided in the input text.) ``` -------------------------------- ### Check Store Delayed Delivery Push Status (JSON Example) Source: https://developer.waimai.meituan.com/home/docDetail/34 This example demonstrates the expected JSON response when querying the '/poi/logistics/isDelayPush' endpoint. It shows a successful response with a status code, message, and data indicating whether delayed push is supported and the duration in seconds. ```json { "code": 0, "msg": "success", "data": { "support_delay_push": 1, "delay_push_second": 600 } } ``` -------------------------------- ### Store Information Management Source: https://developer.waimai.meituan.com/home/doc/food/1 APIs for creating, retrieving, updating, and managing basic store information. ```APIDOC ## POST /poi/save ### Description Creates or updates store information. ### Method POST ### Endpoint /poi/save ### Parameters #### Request Body - **store_info** (object) - Required - Detailed store information. ### Request Example ```json { "store_info": { "name": "Example Store", "address": "123 Main St", "phone": "123-456-7890" } } ``` ### Response #### Success Response (200) - **status** (string) - Indicates the success or failure of the operation. #### Response Example ```json { "status": "success" } ``` --- ## GET /poi/getids ### Description Retrieves store IDs. ### Method GET ### Endpoint /poi/getids ### Response #### Success Response (200) - **ids** (array) - A list of store IDs. #### Response Example ```json { "ids": ["store1", "store2"] } ``` --- ## POST /poi/mget ### Description Retrieves detailed information for multiple stores in bulk. ### Method POST ### Endpoint /poi/mget ### Parameters #### Request Body - **ids** (array) - Required - A list of store IDs to retrieve information for. ### Request Example ```json { "ids": ["store1", "store2"] } ``` ### Response #### Success Response (200) - **stores** (array) - A list of store detail objects. #### Response Example ```json { "stores": [ { "id": "store1", "name": "Example Store 1", "status": "open" }, { "id": "store2", "name": "Example Store 2", "status": "closed" } ] } ``` ``` -------------------------------- ### POST /api/v1/wm/IM/getConnectionTokenWithCount Source: https://developer.waimai.meituan.com/home/docDetail/739 Obtains multiple IM2.0 tokens required for establishing long connections. This is a new version of the token acquisition interface. ```APIDOC ## POST /api/v1/wm/IM/getConnectionTokenWithCount ### Description This endpoint is used to obtain multiple IM2.0 tokens for establishing long connections. It's a new interface for this functionality. ### Method POST ### Endpoint /api/v1/wm/IM/getConnectionTokenWithCount ### Parameters #### Query Parameters - **required_token_count** (int) - Required - The number of tokens to obtain. Recommended value is 3, with a maximum of 5. ### Request Example ```json { "required_token_count": 3 } ``` ### Response #### Success Response (200) - **code** (int) - Status code, 0 for success, 1 for failure. - **msg** (string) - Prompt message. - **data** (object) - Contains token information. #### Response Example ```json { "code": 0, "msg": "success", "data": { "tokens": [ "token1", "token2", "token3" ] } } ``` #### Error Response - **code** (int) - Status code, 0 for success, 1 for failure. - **msg** (string) - Error message. #### Error Response Example ```json { "code": 1, "msg": "Error message describing the failure" } ``` ```