首页 > 分享 > 花娃API 接口文档

花娃API 接口文档

花匠小妙招
2024-11-03 19:22

开放平台

花娃接口说明

基本信息

Path： /newapi/

Method： POST

接口描述：

概述

使用花娃API需要先申请API密钥，包含商户账号 ( api_account ) 和安全校验码 ( keycode ) ，其中商户账号将作为参数包含在每一个请求中发送，而安全校验码负责生成请求串的签名，请妥善保存。

API请求地址

https://open.huawa.com/newapi/action

其中action为具体接口名，例如导入订单接口为https://open.huawa.com/newapi/import

签名方法

这里介绍API请求中签名 ( sign ) 的生成方法。假设已获得密钥ID和私钥如下 (不含单引号)：

api_account = '6788429550' keycode = '98561aff7ah38adf04804c41' 例如请求的POST数据如下（不包含sign）请确保去除数据首尾空格，否则导入将会失败： istimer=0 &delivery_time=2 &songdate=2017-04-01 &receive_name=白百何 &receive_mobile=18910981098 &area_info=四川省成都市锦江区 &address=华润二十四城1栋10单元602室 &material=11支红粉玫瑰加满天星点缀 &quantity=1 &order_amount=280 &cb_price=280 &remark=请务必保证花材新鲜 &picurl=http://images.aihuaju.com/1.jpg,http://images.aihuaju.com/2.jpg &card_description=生日快乐小百合 &send_mobile=13960882688 &invoice_title= &seller_order= &api_account=6788429550 &timestamp=1366789919 签名步骤按参数名进行升序排列：

address=华润二十四城1栋10单元602室 &api_account=6788429550 &area_info=四川省成都市锦江区 &card_description=生日快乐小百合 &cb_price=280 &delivery_time=2 &invoice_title= &istimer=0 &material=11支红粉玫瑰加满天星点缀 &order_amount=280 &picurl=http://i.ahj.cm/g/1/2017/01/1_05369366745071968_418.jpg,http://i.ahj.cm/g/1/2017/01/1_05386771287869773_418.jpg &quantity=1 &receive_mobile=18910981098 &receive_name=白百何 &remark=请务必保证花材新鲜 &seller_order= &send_mobile=13960882688 &songdate=2017-04-01 &timestamp=1366789919 重新拼接，得到最终待校验的字符串(注意不能urlencode，值前后不能加空格)：

address=华润二十四城1栋10单元602室&api_account=6788429550&area_info=四川省成都市锦江区&card_description=生日快乐小百合&cb_price=280&delivery_time=2&istimer=0&material=11支红粉玫瑰加满天星点缀&order_amount=280&picurl=http://i.ahj.cm/g/1/2017/01/1_05369366745071968_418.jpg,http://i.ahj.cm/g/1/2017/01/1_05386771287869773_418.jpg&quantity=1&receive_mobile=18910981098&receive_name=白百何&remark=请务必保证花材新鲜&send_mobile=13960882688&songdate=2017-04-01&timestamp=1366789919 计算签名

（1）MD5签名方式：
接口新增传参”is_net“，值为1，并且此参数不参与签名
将API密钥的私钥 ( api_account ) 作为key，生成被签名串的 MD5 签名
将签名进行 Base64 编码
将 Base64 编码后的结果进行 URL 编码
将签名得到的值赋给参数”sign”并传递

（2）SHA256签名方式：
将API密钥的私钥 ( api_account ) 作为key，生成被签名串的 HMAC-SHA256 签名
将签名进行 Base64 编码
将 Base64 编码后的结果进行 URL 编码
将签名得到的值赋给参数”sign”并传递

php代码示例

$params = array(); $params['address'] = '华润二十四城1栋10单元602室'; $params['area_info'] = '四川省成都市锦江区'; $params['card_description'] = '生日快乐小百合'; $params['cb_price'] = 280; $params['delivery_time'] = 2; ksort($params); $str = urldecode(http_build_query($params)); $hash = mhash(MHASH_SHA256, $str, $keycode);// SHA256结果=====>(��A�fݟ1B��m2v�)Jx{�W%obE�9 $params['sign'] = base64_encode($hash);// base64结果=====>KJvSQRD2Zh/dnzFCtf5tMnaxKQITSnh79lclb2JFnjk= $url = "https://open.huawa.com/newapi/import"; $data = http_post($url, $params);

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent import_huawa 是 import_huawa 必须传入

返回数据

名称类型是否必须默认值备注其他信息

花图审核_copy

基本信息

Path： /newapi/examine_image_1721286394954

Method： POST

接口描述：

{"result":1,"data":[]}

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_black_list 是 get_black_list 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123455 订单号 type text 否 2 1通过 2不通过 reason_ids text 否 1,2,3,4 type=2 必传拒绝的原因集合，多个用，分割 remark text 否花图太小 type=2 必传拒绝的原因

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须 datastring []非必须

item 类型: string

├─ 非必须

确认订单完成

基本信息

Path： /newapi/order_receive

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是

Body

参数名称参数类型是否必须示例备注 order_id text 是 16921787 订单号 password text 是 11111111 支付密码

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须 datastring []必须

item 类型: string

├─ 非必须

导入单个订单

基本信息

Path： /newapi/import

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent import_huawa 是 import_huawa 必须传入

Body

参数名称参数类型是否必须示例备注 member_name text 否漫漫鲜花网指定花店的会员名，适用于指定花店下单 istimer text 是 0 是否定时配送，1-是，0-否 delivery_time text 是 1 配送时段，如果istimer等于0时这个值必填，1:不限时段，2:08-10点，3:10-12点，4:12-14点，5:14-16点，6:16-18点，7:18-20点，8:20-22点，15:上午，16:下午，17:晚上，99:自定义时间 s_time text 是配送时间为自定义必须传入参数：自定义配送开始时间 e_time text 是配送时间为自定义必须传入参数：自定义配送结束时间 songdate text 否 2016-12-25 13 配送时间，istimer=1时传入格式YYYY-mm-dd H:i:s，例如2016-12-25 13:45:51 ，istimer=0时传YYYY-mm-dd，例如2016-12-25 receive_name text 是杨某收花人姓名 receive_tel text 是 028-11111111 收花人座机 receive_mobile text 是 18511111111 收花人手机 area_info text 是四川省成都市武侯区收花人地区，省市区以空格隔开 address text 是交子大道100号收花人详细地址 material text 否 11支红粉玫瑰加满天星点缀鲜花花材 quantity text 是 1 商品数量 sales_price text 否 200 销售价。为了方便您能够通过花娃查看您的利润值，并形成您的周、月、季等数据分析报表，以及给您的员工进行利润值排名等，强烈建议您填写真实销售价格。 order_amount text 否 60 出价，转单价必须大于10元 remark text 否请按时送到订单备注 picurl text 否 http 图片地址，请使用远程图片路径，以http://开头，只支持jpg和png格式，最大4M card_description text 否祝身体健康贺卡内容 send_mobile text 是 18511111111 送花人电话 invoice_title text 是花娃网络科技有限公司发票抬头 seller_order text 否 A0001 订单在商家自己订单系统中的编号 is_payment text 是 0 默认0 1支付 0不支付；值为1时订单将直接发布到“等待接单”状态，同时如果有指定花店的会员名（member_name），订单将直接发布到“指定待接收”状态值为0时，订单状态为“待发布” 。说明：当账号余额不足时订单会导入到“待发布”状态. goods_type text 是蛋糕商品类型，默认：鲜花 examine_status text 是 0 花图审核：0、不审核 1未提交 2待审核 3成功 4失败 more_goods_data text 是 urlencode(json_encode(more_goods_data)) 多商品信息(string), 其中 goods_image-商品图片 quantity-商品数量 goods_material-商品描述实例（urlencode之前的数据）： [{"goods_image":"http://p0.meituan.net/sgopen/c0604b26011d24d0e67dd4d0382add1a838723.png","quantity":1,"goods_material":"精美贺卡"},{"goods_image":"http://p0.meituan.net/scproduct/adfc28d8166b30463377763e5f17b5a1644247.jpg,http://p0.meituan.net/scproduct/49bbe12f70efdfa1e6abcff9604437db367047.jpg","quantity":1,"goods_material":"33枝粉玫瑰"}] is_self_delivery text 否 0 是否自提订单 0-非自提(配送单) 1-自提订单 x_axis text 否 104.041963 百度地图经度（注：经纬度必须同时传入才会使用，同时必须使用百度地图经纬度，其他地图经纬度会导致定位异常） y_axis text 否 30.562876 百度地图纬度（注：经纬度必须同时传入才会使用，同时必须使用百度地图经纬度，其他地图经纬度会导致定位异常）

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: 1

order_idstring必须订单id

mock: @float

order_snstring必须订单编号

mock: @string

is_checknumber必须是否是待发布 1：是 2：不是

mock: 1

order_stastring必须当前订单状态 22 待发布； 40 待接单；50 指定待接收；55 已接收待配送；

mock: @string

取消订单

基本信息

Path： /newapi/order_cans

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent cans_order 是 cans_order 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 否 123456 订单id order_id 和 order_sn 必须存在一个 order_sn text 否 20190710-124920-59021 订单编号 order_id 和 order_sn 必须存在一个 cans_reark text 是客户取消取消原因

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态 datastring []非必须

item 类型: string

├─ 非必须

报价花店列表

基本信息

Path： /newapi/select_store_list

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent select_store_list 是 select_store_list 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123456

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须状态 dataobject非必须├─ price_listobject []非必须

item 类型: object

├─ store_qqstring非必须店铺qq├─ store_mobilestring非必须店铺电话├─ area_infostring非必须店铺地址├─ store_namestring非必须店铺名称├─ price_idstring非必须报价id├─ order_idstring非必须订单id├─ pricestring非必须报价价格├─ add_timestring非必须报价时间├─ security_depositstring非必须保证金├─ store_ordersstring非必须接单量├─ praise_ratestring非必须信誉度├─ timeoutstring非必须报价有效时间├─ last_placeorder_timestring非必须最近接单时间├─ distancestring非必须订单到花店的距离（单位公里）├─ store_snstring必须花店编号

指定花店

基本信息

Path： /newapi/assign_store

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent assign_store 是 assign_store 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123456 订单id member_name text 是漫漫鲜花网指定花店会员名

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须 datastring []非必须

item 类型: string

├─ 非必须

指定花店配送（新）

基本信息

Path： /newapi/assign_store_amount

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent assign_store_amount 是 assign_store_amount 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123456 订单id member_name text 是漫漫鲜花网指定花店会员名 amount text 是 60 价格 payment_password text 是 dasda= 支付密码

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态 datastring []非必须

item 类型: string

├─ 非必须

查询订单列表

基本信息

Path： /newapi/orderlist

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent orderlist 是 orderlist 必须输入

Body

参数名称参数类型是否必须示例备注 pagesize text 否 1 每页数量 curpage text 否 10 当前查询第几页 order_sn text 否 20190710-124920-59021,20190710-124920-59022,20190710-124920-59023 订单编号订单号和商户号必须存在一个 seller_order text 否 A1001,B1002,C1003 商户号订单号和商户号必须存在一个 status text 否 fail 订单状态，可选：fail下单方主动取消，no_pay待支付，check待发布，refund退款中，cancel已取消，expired已过期，untreated等待接收，wait等待接单，wait_bid竞价单待出价，trading_in配送中，confirm待确认完成，success已完成 receive_name text 否杨某收货人姓名 receive_mobile text 否 185111111 收货人手机 receive_address text 否成都收货人地址 addtime_start text 否 2019-05-10 订单创建时间起始 addtime_end text 否 2019-05-11 订单创建时间终止 deliverytime_start text 否 2019-05-10 订单配送时间起始 deliverytime_end text 否 2019-05-11 订单配送时间终止

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: @float

dataobject非必须├─ totalcountstring必须订单总数

mock: @float

├─ pagecountnumber必须页数总数

mock: @float

├─ orderlistobject []非必须订单列表

item 类型: object

├─ order_typestring必须订单类型，1指定花店，2抢单

mock: @float

├─ order_idstring必须订单id，订单唯一标识

mock: @float

├─ order_snstring必须订单编号，订单唯一标识，更直观

mock: @string

├─ member_namestring必须接单方会员名

mock: @string

├─ store_idstring必须花店id

mock: @float

├─ store_namestring必须花店名称

mock: @string

├─ store_mobilestring必须花店手机

mock: @string

├─ store_qqstring非必须花店qq

mock: @string

├─ refund_reasonstring非必须退款原因

mock: @string

├─ refund_amountstring非必须花店同意退款金额

mock: @float

├─ goods_thumbstring必须缩略图

mock: @string

├─ goods_materialstring必须花材描述

mock: @string

├─ area_infostring必须收货人地区信息

mock: @string

├─ provincestring必须收货人省份

mock: @string

├─ citystring必须城市

mock: @string

├─ areastring必须区

mock: @string

├─ receive_namestring必须收货人姓名

mock: @string

├─ receive_mobilenull必须收货人手机

mock: @string

├─ receive_addressstring必须收货人地址

mock: @string

├─ delivery_datestring必须配送日期

mock: @string

├─ order_amountstring必须出价金额

mock: @float

├─ status_infonull必须订单状态待付款,等待接单,待接收,待接收,花店拒绝,未接单已过期,待自提,已接收,配送中,待确认完成,退款中,不同意退款,退款成功,申诉中,申诉完成,主动取消,待发布,已完成,待回款

mock: @float

├─ riseprice_countstring非必须请求涨价的花店数量

mock: @float

├─ back_amountstring非必须货到付款回款金额

mock: @float

├─ istopaystring必须是否到付，1是，0否

mock: @float

├─ isconfirmstring必须是否待确认收款，1是，0否

mock: @float

├─ isbackstring必须是否已经回款，1是，0否

mock: @float

├─ pay_statestring必须是否已支付，1是，0否

mock: @float

├─ seller_orderstring非必须商户号

mock: @string

├─ send_imgurlstring必须图片地址，多张以英文逗号隔开├─ examine_statusstring必须花图审核状态 0、不审核 1未提交 2待审核 3成功 4失败├─ send_imgurl_timestring必须实拍图上传时间（时间戳）├─ examine_expire_timestring必须花图审核有效期（时间戳）├─ refund_statestring必须退款状态;1未处理;2不同意;3同意;5系统同意├─ remarkstring必须订单备注├─ card_descriptionstring必须贺卡├─ more_goods_dataobject []必须多商品信息

item 类型: object

├─ goods_materialstring必须花材信息├─ quantitystring必须数量├─ goods_imagestring []必须图片，多个

item 类型: string

├─ 非必须

获取城市列表

基本信息

Path： /newapi/get_city

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_city 是 get_city 必须输入

Body

参数名称参数类型是否必须示例备注 area_id text 是 0 城市 id, 如果显示所有省，请传 0

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: @float

dataobject []必须

item 类型: object

├─ area_idstring必须城市id

mock: @float

├─ area_namestring必须城市名称

mock: @string

获取花娃账号余额

基本信息

Path： /newapi/get_account_balances

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent account_balances 是 account_balances 必须输入

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: @float

dataobject非必须├─ member_idstring必须会员id

mock: @float

├─ member_namestring必须会员名

mock: @string

├─ member_mobilestring必须会员手机

mock: @string

├─ member_emailstring必须会员邮箱

mock: @string

├─ amountstring必须可用余额

mock: @float

├─ freezestring必须冻结金额

mock: @float

├─ depositstring必须保证金

mock: @float

追加订单价格

基本信息

Path： /newapi/add_price

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent add_price 是 add_price 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123456 订单id add_amount text 是 20 追加金额 payment_password text 是 wqeqwew= 支付密码

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: @float

datastring []非必须

item 类型: string

├─ 非必须

选择报价花店

基本信息

Path： /newapi/select_price

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent select_price 是 select_price 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123456 订单id price_id text 是 11 花店报价id payment_password text 是 ewrweew= 支付密码

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: @float

datastring []非必须

item 类型: string

├─ 非必须

申请售后

基本信息

Path： /newapi/complain_save_new

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent select_price 是 select_price 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123456 订单id input_complain_pic text 是 11 图片凭证，多张以英文逗号隔开 input_complain_content text 是 8013 原因：8013 - 协商退款　8001 - 漏单　8002 - 误单　8003 - 花材不符　8004 - 质量问题　8005 - 配材不符　8006 - 包装不符　8007 - 虚假操作　8008 - 恶意透露价格　8010 - 恶意骚扰　8011 - 贺卡问题　8012 - 第三方差评 refund text 是 1 自定义退款金额 input_order_problem text 是测试详细内容 complain_need text 是 5100 投诉id: 5013 - 退还订单金额30%　5015 - 退还订单金额50%　5018 - 退还订单金额80%　5000 - 全额退款　5005 - 全额退款，赔付订单金额50%　5006 - 全额退款，赔付订单金额60%　5007 - 全额退款，赔付订单金额70%　5008 - 全额退款，赔付订单金额80%　5009 - 全额退款，赔付订单金额90%　5010 - 全额退款，赔付订单金额100%　5100 - 部分退款，自定义金额

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: @float

datastring []非必须

item 类型: string

├─ 非必须

取消申请

基本信息

Path： /newapi/cancel_refund

Method： POST

接口描述：

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent select_price 是 select_price 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 123456 订单id

返回数据

名称类型是否必须默认值备注其他信息 resultnumber必须状态

mock: @float

datastring []非必须

item 类型: string

├─ 非必须

获取订单第三方配送信息

基本信息

Path： /newapi/get_courier_info

Method： POST

接口描述：

{ "result": "1", "data": { "de_member_name": "测试骑手", "de_member_phone": "15644458895", "lng": "16.222111", "lat": "106.24444", "delivery_no": "6666-99999", "platform": "5", "status": "3" } }

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_courier_info 是 get_courier_info 必须输入

Body

参数名称参数类型是否必须示例备注 order_id text 是 1652201 订单id

返回数据

名称类型是否必须默认值备注其他信息 resultstring必须结果状态

mock: 1

dataobject必须├─ de_member_namestring必须骑手名

mock: 测试骑手

├─ de_member_phonestring必须骑手电话

mock: 15644458895

├─ lngstring必须骑手当前位置-经度

mock: 16.222111

├─ latstring必须骑手当前位置-纬度

mock: 106.24444

├─ delivery_nostring必须配送订单编号

mock: 6666-99999

├─ platformstring必须配送平台 shansongv5:闪送,dada:达达,dada:达达,uu:UU跑腿,shunfeng:顺丰,jdwl:京东同城,fengniao:蜂鸟快送,self_distribution:商家自配送

mock: 5

├─ statusstring必须配送订单状态 1-待接单 2-待取件 3-配送中

mock: 3

根据店铺名获取店铺会员名

基本信息

Path： /newapi/storename_to_membername

Method： POST

接口描述：

{ "result": 1, "data": { "total_num": 17, "data": [ "13560259578", "18851599579", "13582288176", "漫漫花艺工作室", "高跟鞋482" ] } }

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_courier_info 是 get_courier_info 必须输入

Body

参数名称参数类型是否必须示例备注 store_name text 是漫漫店铺名 page text 是 1 页码 limit text 是 10 每页显示个数

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须 dataobject非必须├─ total_numnumber非必须总数├─ datastring []非必须数据

item 类型: string

├─ 非必须店铺会员名

获取拉黑列表

基本信息

Path： /newapi/get_black_list

Method： POST

接口描述：

{ "result": 1, "data": { "count": "1", "pagecount": 1, "list": [ { "member_id": "252046", "id": "2277", "black_time": "1717654945", "member_name": "ces233", "member_qq": "1174889265", "member_mobile": "13689610664", "member_areainfo": "四川省成都市锦江区", "member_address": "国际金融中心", "black_reason": "qweqweqweqw", "store_name": "扣扣空间", "store_id": "471728" } ] } }

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_black_list 是 get_black_list 必须输入

Body

参数名称参数类型是否必须示例备注 keyword text 否漫漫关键词搜索 page text 否 1 页码（默认1） limit text 否 10 每页显示个数(最大50)

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须 dataobject非必须├─ countstring非必须├─ pagecountnumber非必须├─ listobject []非必须

item 类型: object

├─ member_idstring非必须拉黑的会员ID├─ idstring非必须拉黑Id├─ black_timestring非必须拉黑时间├─ member_namestring非必须拉黑的会员名├─ member_qqstring非必须拉黑的会员QQ├─ member_mobilestring非必须拉黑的会员手机号├─ member_areainfostring非必须会员的省市区├─ member_addressstring非必须会员的详细地址├─ black_reasonstring非必须拉黑原因├─ store_namestring非必须门店名称├─ store_idstring非必须门店id

花图审核

基本信息

Path： /newapi/examine_image

Method： POST

接口描述：

{"result":1,"data":[]}

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_black_list 是 get_black_list 必须输入

Body

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须 datastring []非必须

item 类型: string

├─ 非必须

花图审核原因列表

基本信息

Path： /newapi/get_examine_reason

Method： POST

接口描述：

{ "result": 1, "data": { "花材类": [ { "id": "1", "name": "颜色不符" }, { "id": "2", "name": "数量不符" }, { "id": "3", "name": "品种不符" }, { "id": "4", "name": "质量问题" } ], "配花/草": [ { "id": "5", "name": "颜色不符" }, { "id": "6", "name": "数量不符" }, { "id": "7", "name": "品种不符" }, { "id": "8", "name": "质量不符" } ], "包装类": [ { "id": "9", "name": "材质不符" }, { "id": "10", "name": "造型不符" }, { "id": "11", "name": "颜色不符" } ], "附属物品": [ { "id": "12", "name": "贺卡遗漏" }, { "id": "13", "name": "小熊遗漏" } ], "拍摄类": [ { "id": "14", "name": "未能展示商品全貌" }, { "id": "15", "name": "照片模糊不清" } ] } }

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_black_list 是 get_black_list 必须输入

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须 dataobject非必须├─ 花材类object []非必须

item 类型: object

├─ idstring必须原因id├─ namestring必须原因名称├─ 配花/草object []非必须

item 类型: object

├─ idstring必须├─ namestring必须├─ 包装类object []非必须

item 类型: object

├─ idstring必须├─ namestring必须├─ 附属物品object []非必须

item 类型: object

├─ idstring必须├─ namestring必须├─ 拍摄类object []非必须

item 类型: object

├─ idstring必须├─ namestring必须

美团闪购接口转发

基本信息

Path： /newapi/mtsg_post_transfer

Method： POST

接口描述：

{ "result": 1, "data": { "data": [ { "open_level": 1, "latitude": 36814608, "time_select": 1, "pre_book": 0, "remark": "", "location_id": 0, "invoice_support": 0, "logistics_codes": "0000", "ctime": 1716860404, "invoice_description": "", "is_online": 1, "app_id": 5703, "shipping_time": "07:00-12:00,12:30-23:00", "longitude": 81661728, "pre_book_min_days": 0, "address": "南极洲04号站", "utime": 1721349040, "tag_name": "大型超市/卖场", "pre_book_max_days": 0, "shipping_fee": 2, "invoice_min_price": 0, "app_poi_code": "5703_21605337", "phone": "4009208801", "name": "压测测试门店_t_77hN6r6O_003", "promotion_info": "", "standby_tel": "4009208801", "pic_url": "http://p1.meituan.net/160.120.90/crm/__37375183__1582979.png", "city_id": 653200 } ], "success_list": [ { "open_level": 1, "latitude": 36814608, "time_select": 1, "pre_book": 0, "remark": "", "location_id": 0, "invoice_support": 0, "logistics_codes": "0000", "ctime": 1716860404, "invoice_description": "", "is_online": 1, "app_id": 5703, "shipping_time": "07:00-12:00,12:30-23:00", "longitude": 81661728, "pre_book_min_days": 0, "address": "南极洲04号站", "utime": 1721349040, "tag_name": "大型超市/卖场", "pre_book_max_days": 0, "shipping_fee": 2, "invoice_min_price": 0, "app_poi_code": "5703_21605337", "phone": "4009208801", "name": "压测测试门店_t_77hN6r6O_003", "promotion_info": "", "standby_tel": "4009208801", "pic_url": "http://p1.meituan.net/160.120.90/crm/__37375183__1582979.png", "city_id": 653200 } ], "result_code": 1 } }

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是 User-Agent get_black_list 是 get_black_list 必须输入

Body

参数名称参数类型是否必须示例备注 api_url text 是 /api/v1/poi/save 例如 /api/v1/poi/save 剔除掉 https://waimaiopen.meituan.com外的部分 is_post text 否 0 是否采用post请求 1-采用 0-不采用 app_poi_code text 是 123311 美团闪购的店铺编号 mtsg_data text 否 urlencode(json_encode(mtsg_data)) 请求到美团闪购的参数

返回数据

名称类型是否必须默认值备注其他信息 resultnumber非必须 dataobject非必须美团返回的数据

开放平台通知接口

数据签名

基本信息

Path： /30/211

Method： POST

接口描述：

通知消息数据签名

概述

数据签名验证可保证数据来源的安全性，建议使用签名对数据进行验证接收到花娃推送的数据后，可对数据进行签名验证，需要开启api导入，已经生成商户账号api_account 和安全校验码keycode。

签名过程

在已经获取到账户安全校验码的条件下按字典顺序排序参数,拼接成字符串在拼接好的字符串后面拼接 &key=安全校验码 MD5加密字符串将字符串转为大写签名代码示例(PHP)

//签名方法 /** * @param array $origin_data 进行签名的数据 * @param sting $key_code 安全校验码 */ function signData(array $origin_data, $key_code = ''){ //签名步骤一：按字典序排序参数 ksort($origin_data); $string = $this->ToUrlParams($origin_data); //签名步骤二：在string后加入KEY $string = $string . "&key=" . $key_code; //签名步骤三：MD5加密 $string = md5($string); //签名步骤四：所有字符转为大写 $result = strtoupper($string); // print_r("--------".$result);die; return $result; } // 签名组装字符串 function ToUrlParams($origin_data){ $buff = ""; foreach ($origin_data as $k => $v) { if($k != "sign" && $v != "" && !is_array($v)){ $buff .= $k . "=" . urlencode($v) . "&"; } } $buff = trim($buff, "&"); return $buff; } 验签过程代码示例(PHP)

$postDataArr = json_decode(file_get_contents("php://input"), true); $postData = $postDataArr['data']; $signOrigin = $postData['sign_data']; //服务端的签名数据 unset($postData['sign_data']); //去掉签名数据 $key = 'b817f322013d77c8522a81d5c73ffd63'; //安全校验码 $signString = signData($postData, $key); if ($signString != $signOrigin) { echo '验签失败'; file_put_content('a.txt', '签名验证失败===>'. var_export($postData, true) ."rn".'原始数据==>' . var_export($postDataArr['data'], true)); die; } echo '验签成功'; file_put_conten('a.txt', '签名成功===>'. $signString);

请求参数

Headers

参数名称参数值是否必须示例备注 Content-Type application/x-www-form-urlencoded 是

订单api导入订单通知消息

基本信息

Path： /30/21

Method： POST

接口描述：

api订单导入订单通知消息

概述

开通api导入

此通知在订单状态发生改变时，系统通过api导入-通知地址接口向下单方通知订单最新消息。

1.下单方在花娃上第三方订单管理中,店铺管理开通"api导入"功能，系统会生成商户账号api_account 和安全校验码keycode。 2.输入通知地址接口后，系统会在订单状态发生改变时，向此地址推送消息数据。如填写： http://www.dumain.com 必须保证接口在任何情况下http状态值200。否则无法填写接口名 3.输入的接口地址必须保证在任何情况下都可访问，接收数据方法为POST。若不输入此地址，则不会通知。 4.通知可能会重复，请严格按照文档要求返回数据，避免重复通知。 5.若接口返回的数据错误,通知会在短时间内发起三次，三次后则不再进行通知。

安全校验码验证

开发人员在配置通知接口时，需要保证接口输出{"data":"HW_SUCCESS"} json字符串。

echo json_encode(array('data'=>'HW_SUCCESS'));exit; // 验证成功后再处理业务逻辑 //TODO 接口的业务逻辑

接口说明

适用对象：开通"api导入"的花娃下单方 请求方式：POST,Content-type为 application/json 回调URL：该url 是在开通"api导入"后输入的接口地址，示例:http://www.domain.com/api/get_params

通知参数

{"status":1,"data":{"push_content":"u8ba2u5355uff1a20220601-194007-24375uff0cu7533u8bc9u5df2u7ecfu5b8cu6210","api_notify_url":"http://hwtest.tfxk.org/index.php?c=cc&a=aa","order_sn":"20220601-194007-24375","order_state":"FINISH_COMPLAINT","order_amount":"50.00","pay_amount":"50.00","seller_order":"","return_refund_info":{"refund_reason":"u82b1u6750u4e0du7b26,u6d4bu8bd5u7533u8bc9,u8fdbu5165u552eu540e","refund_time":"1654084187","refund_amount":"12.00","seller_refund_time":"1654084211"},"return_complaint_info":{"complain_content":"u6d4bu8bd5u7533u8bc9,u8fdbu5165u552eu540e","complain_message":"u6d4bu8bd5u7533u8bc9,u8fdbu5165u552eu540e","complain_subject_content":"u82b1u6750u4e0du7b26","appeal_datetime":"1654084211","complain_handle_datetime":"0","final_handle_datetime":"0","final_handle_message":"","refund_buy_amount":"0.00","refund_seller_amount":"0.00"}}} 公共参数字段意义参数值示例 status 通知状态,发送通知成功 1 data 通知数据 object data参数详解字段意义参数值示例是否必须存在 push_content 推送的内容订单:20220427-111741-05663,已经由花店【陌上花开花铺】开始配送是 api_notify_url 接收数据的地址 http://www.domain.com/api/get_params 是 order_sn 订单编号 20220427-111741-05663 是 order_amount 订单金额 50.00 是 seller_order 商家订单系统id号 0856652566855 是 order_state 订单状态 PAY_ORDER_SUCCESS 是 return_pay_info 订单支付数据,当订单状态为支付成功时此参数存在 object 否 return_store_info 花店数据,当订单状态为指定给花店、花店接单、花店拒绝接单、花店开始配送、订单送达、完成订单时此参数存在 object 否 return_delivery_info 配送数据,当订单状态为花店开始配送、订单送达、完成订单时此参数存在 object 否 return_refund_info 申请退款数据,当订单状态为申请退款、花店同意退款、花店拒绝退款、发起申诉、申诉完成时时此参数存在 object 否 return_complaint_info 订单申诉数据,当订单状态为订单发起申诉、申诉完成时此参数存在 object 否 return_cancel_info 取消订单数据,当订单取消时此参数存在 object 否 return_bidding_price 花店报价,当有花店报价是此参数存在 object 否订单状态参数详解 order_state 参数值意义 PAY_ORDER_SUCCESS 支付订单成功 POINT_STORE_ORDER 指定订单给花店 STORE_REFUSE_ORDER 花店拒接指定单 STORE_ACCEPT_ORDER 花店接单 START_DELIVERY_ORDER 花店开始配送订单 ORDER_ACHIEVE 订单已送达 ORDER_FINISH 订单完成 CANCEL_ORDER 取消订单 APPLY_REFUND 申请退款 STORE_AGREE_REFUND 花店同意同款 STORE_REFUSE_REFUND 花店拒绝退款 APPLY_COMPLAINT 订单发起申诉 FINISH_COMPLAINT 申诉完成 STORE_SEND_IMG 花店上传花图 ORDER_STORE_PRICE 花店报价订单支付数据详解 return_pay_info 字段意义参数值示例 pay_time 支付时间（时间戳） 1563271245 花店数据据详解 return_store_info 字段意义参数值示例是否必须存在 store_name 花店名称 1563271245 是 store_mobile 花店电话 15022236654 是 store_addr_info 花店地址四川省成都市武侯区泉南大街与顺德路交叉口西行100米路南是 accept_time 接单时间,当状态值为花店接单时存在 1563271245 否配送数据详解 return_delivery_info 字段意义参数值示例 deliver_type 配送方式,0花店自配送 1三方配送 0 取消订单数据详解 return_cancel_info 字段意义参数值示例 cancel_time 取消订单时间戳 1558390672 申请退款数据详解 return_refund_info 字段意义参数值示例是否必须存在 refund_reason 申请退款原因协商退款是 refund_time 申请退款时间 1563271245 是 refund_amount 申请退款金额 12.00 是 seller_refund_time 卖家处理退款时间,当订单状态为花店同意退款、花店拒绝退款时，此参数存在 1563271245 否订单申诉数据详解 return_complaint_info 字段意义参数值示例是否必须存在 complain_content 投诉内容申请退款金额12.80元是 complain_message 被投诉商品的问题描述花材不符,花材不好看是 complain_subject_content 商家不同意退款 1563271245 是 appeal_datetime 提起申诉时间 1569228676 是 complain_handle_datetime 卖家处理退款时间,当订单状态申诉完成时存在 1563271245 否 final_handle_datetime 最终处理时间,当订单状态申诉完成时存在 1563271245 否 final_handle_message 最终处理意见,当订单状态申诉完成时存在可以退款否 refund_buy_amount 返给买家的金额,当订单状态申诉完成时存在 12.80 否 refund_seller_amount 返给卖家金额,当订单状态申诉完成时存在 47.20 否花店报价数据 return_bidding_price 字段意义参数值示例是否必须存在 price 报价金额 12.80 是 add_time 报价时间 1663660965 是 timeout 报价过期时间 1663700565 是花店报价列表数据新增(24.6.5) return_order_store_price 字段意义参数值示例是否必须存在 price_id 报价Id 2084902 是 store_name 报价花店名称星海是 store_id 报价店铺ID 471762 是 price 报价金额 100.00 是 add_time 报价时间 1717568352 是 status 状态值 0(枚举值 0：报价中 1：已选择此报价 2：报价过期/已取消) 是 timeout 报价过期时间 1663700565 是

回调示例

接收的数据为json字符串. 开发者在接口地址中接收POST参数即可。示例代码(PHP)

file_put_contents('data.log', '接收数据==>' . var_export(file_get_contents("php://input"),true)); //记录日志数据为json字符串 // 转为数组后的数据示例 array ( 'status' => 1, 'data' => array ( 'push_content' => '订单：20220601-194007-24375，申诉已经完成', 'api_notify_url' => 'http://hwtest.tfxk.org/index.php?c=cc&a=aa', 'order_sn' => '20220601-194007-24375', 'order_state' => 'FINISH_COMPLAINT', 'order_amount' => '50.00', 'pay_amount' => '50.00', 'seller_order' => '', 'return_refund_info' => array ( 'refund_reason' => '花材不符,测试申诉,进入售后', 'refund_time' => '1654084187', 'refund_amount' => '12.00', 'seller_refund_time' => '1654084211', ), 'return_complaint_info' => array ( 'complain_content' => '测试申诉,进入售后', 'complain_message' => '测试申诉,进入售后', 'complain_subject_content' => '花材不符', 'appeal_datetime' => '1654084211', 'complain_handle_datetime' => '0', 'final_handle_datetime' => '0', 'final_handle_message' => '', 'refund_buy_amount' => '0.00', 'refund_seller_amount' => '0.00', ), ), ) // TODO 处理数据逻辑

// TODO 成功直接输出 HW_SUCCESS
echo json_encode(array('data'=>'HW_SUCCESS'));
exit;