淘宝交易API,修改交易备注taobao.trade.memo.update
需要商家或以上权限才可调用此接口,可重复调用本接口更新交易备注,本接口同时具有添加备注的功能
公共请求参数:
|
---|
公共请求参数: 名称 | 类型 | 必须 | 描述 |
---|
method | String | 是 | API接口名称,例如:taobao.trade.memo.update | 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 false 交易备注 卖家交易备注。最大长度: 1000个字节 flag Number false 1 卖家交易备注旗帜,可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),默认值为0 reset Boolean false true 是否对memo的值置空若为true,则不管传入的memo字段的值是否为空,都将会对已有的memo值清空,慎用;若用false,则会根据memo是否为空来修改memo的值:若memo为空则忽略对已有memo字段的修改,若memo非空,则使用新传入的memo覆盖已有的memo的值 响应参数 名称 类型 示例值 描述 trade Trade 更新交易的备注信息后返回的Trade,其中可用字段为tid和modified tid Number 2231958349 交易编号 (父订单的交易编号) modified Date 2000-01-01 00:00:00 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss 请求示例 PHP $c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TradeMemoUpdateRequest;
$req->setTid("123456789");
$req->setMemo("交易备注");
$req->setFlag("1");
$req->setReset("true");
$resp = $c->execute($req, $sessionKey); |