OkayAPI Docs


API Path: /api/App/Market_MemberAddress/Add

API Description: 添加会员的收货地址,每个会员最多设置20个收货地址。会员可以是小白开放平台的会员,也可以是非小白平台的会员。省、市、区ID可以为空,如有需要可从App.Common_Address.Choose接口获取。使用前请先安装会员收货地址插件

1
API Traffic
HTTP/HTTPS
Protocol
GET/POST
Method
UTF-8
Charset
JSON
Response

API Debug   


API Params

ParameterTypeRequiredDefaultNoteDescription
HTTP_APPKEYStringRequiredMIN: 32Common Put Your APPKEY
member_idStringOptaion会员ID,可以使用小白开放平台的会员体系(即传递uuid+token),或者使用第三方平台的会员体系(即需要自定义指定member_id),这两者应提供至少其中一种,以免无法与会员对应关联。若uuid和member_id均未提供,则不关联会员;若两者都提供,则两者都会进行同时匹配关联。即分为以下四种情况:
  1. 无uuid且无member_id:不绑定任何会员
  2. 有uuid无member_id:绑定小白开放平台会员体系
  3. 无uuid有member_id:绑定第三方会员体系
  4. 有uuid且有member_id:既绑定uuid又绑定member_id
address_nameStringOptaionMAX: 200地址别名,例如:家里、公司、学校、父母家
address_detailsStringOptaionMAX: 1000详细地址,完整的详细地址
provincesIntOptaion0省份id,可以参考使用App.Common_Address.Choose接口的省份编码
cityIntOptaion0城市id,可以参考使用App.Common_Address.Choose接口的城市编码
areaIntOptaion0区县id,可以参考使用App.Common_Address.Choose接口的区县编码
zip_codeStringOptaionMAX: 10邮编
realnameStringOptaionMAX: 100真实姓名
mobileStringOptaionMAX: 20手机号码,例如:13800138000
home_phoneStringOptaionMAX: 20家庭号码,例如:020-88888888
emailStringOptaionMAX: 100邮箱地址,例如:xxx@yesapi.cn

API Debug

KEYREQUIREDVALUE
app_key *Required
member_id Option
address_name Option
address_details Option
provinces Option
city Option
area Option
zip_code Option
realname Option
mobile Option
home_phone Option
email Option

API Response

KEYTypeDescription
err_codeInt操作码,0表示成功(每个会员最多设置20个收货地址),1表示失败,9表示插件未安装
err_msgString错误提示信息,err_code非0时参考此提示信息
idInt新地址ID,失败时返回0

HTTP Response Code

HTTP Status CodeDescription
Http Status = 200Success
Http Status = 400Illegal-Params
Http Status = 401Illegal-Token
Http Status = 402IP-Banned
Http Status = 404API-NOT-Exsits
Http Status = 406Illegal-APPKEY
Http Status = 407APPKEY-Expired-Out
Http Status = 408APPKEY-Busy
Http Status = 409Illegal-Sign
Http Status = 413API-Traffic-NOT-Enough
Http Status = 415API-LOCKED
Http Status = 500Internal-Server-Error