淘宝订单插旗接口详解

taobao.trade.memo.add( 对一笔交易添加备注 )
点击申请接口
根据登录用户的身份（买家或卖家），自动添加相应的交易备注,不能重复调用些接口添加备注，需要更新备注请用taobao.trade.memo.update
公共参数
请求地址:
环境
HTTP地址
HTTPS地址
正式环境
http://gw.api.taobao.com/router/rest
https://eco.taobao.com/router/rest
公共请求参数:
名称
类型
必须
描述
method
String
是
API接口名称，例如:taobao.trade.memo.add
app_key
String
是
TOP分配给应用的AppKey，例如：12345678
session
String
否
用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选
timestamp
String
是
时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟
v
String
是
API协议版本，可选值：2.0
sign_method
String
是
签名的摘要算法，可选值为：hmac，md5，hmac-sha256。
sign
String
是
API输入参数签名结果，签名算法介绍请点击这里
format
String
否
响应格式。默认为xml格式，可选值：xml，json。
simplify
Boolean
否
是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false
公共响应参数:
名称
类型
描述
request_id
String
平台颁发的每次请求访问的唯一标识
error_response
String
请求访问失败时返回的根节点
code
String
请求失败返回的错误码
msg
String
请求失败返回的错误信息
sub_code
String
请求失败返回的子错误码
sub_msg
String
请求失败返回的子错误信息
_response
String
请求成功返回的根节点，'’ 为API名称的下划线模式
请求参数
名称 类型 必须 示例值 描述
tid Number true 123456789 交易编号
memo String true 交易备注 交易备注。最大长度: 1000个字节
flag Number false 1 交易备注旗帜，可选值为：0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色)，默认值为0
响应参数
名称 类型 示例值 描述
trade Trade 对一笔交易添加备注后返回其对应的Trade，Trade中可用的返回字段有tid和created
tid Number 2231958349 交易编号 (父订单的交易编号)
created Date 2000-01-01 00:00:00 交易创建时间。格式:yyyy-MM-dd HH:mm:ss
请求示例
JAVAPHP.NETCURLPythonNodeJSC/C++Python3GOPHP7
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradeMemoAddRequest req = new TradeMemoAddRequest();
req.setTid(123456789L);
req.setMemo(“交易备注”);
req.setFlag(1L);
TradeMemoAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
响应示例
XMLJSON
<trade_memo_add_response>


</trade_memo_add_response>
异常示例
XMLJSON
<error_response>
50
Remote service error
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
</error_response>
错误码解释
错误码
错误消息
解决方案
isv.trade-not-exist
交易不存在
请填写正确的订单号
isv.invalid-parameter
参数无效，格式不对、非法值、越界等
请填写正确的参赛
isv.invalid-permission
必须是此交易的卖家或买家才能添加交易备注
查看是否程序出问导致添加交易备注的交易不属于该卖家，出现错误不要重试