概述

直接履行交易状态的销售伙伴API提供了对直接履行供应商的交易状态的程序化访问.

Version information

版本 : 2021-12-28

Operations

getTransactionStatus
<a name="paths">

路径

<a name="gettransactionstatus">

getTransactionStatus

GET /vendor/directFulfillment/transactions/2021-12-28/transactions/{transactionId}

Description

返回由指定的transactionId指示的交易状态.

使用计划：

Rate (requests per second)	Burst
10	10

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）.上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能看到比这里显示的更高的速率和突发值.更多信息，见使用计划和速率限制在销售伙伴API (opens new window).

Parameters

Type	Name	Description	Schema
Path	transactionId required	Previously returned in response to the POST request of a specific transaction.	string

Responses

HTTP Code	Description	Schema
200	Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier.	TransactionStatus

错误状态代码、描述和模式，见错误响应和模式.

<a name="error-responses-and-schemas">

错误响应和模式

本表包含HTTP状态代码和错误响应的相关信息.

HTTP Code	Description	Schema
400	Request有缺失或无效的参数，无法解析. Headers x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string):唯一的请求参考标识符.	ErrorList
401	请求的授权头格式不正确或不包含有效的令牌. 头 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string):唯一的请求参考标识符.	Error
403	表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. **头信息 x-amzn-RequestId (string):Unique request reference identifier.	Error
404	指定的资源不存在. 头 x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string):独特的请求参考标识符.	Error
415	请求的有效载荷是不支持的格式. 头信息 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string):唯一的请求参考标识符.	Error
429	请求的频率超过了允许的范围. 头 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string):唯一的请求参考标识符.	Error
500	发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string):唯一的请求参考标识符.	Error
503	服务器临时超载或维护. 头信息 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)为这个操作. _注意 _对于这个状态代码，速率限制头已经过时，不再返回. x-amzn-RequestId (string):唯一的请求参考标识.	Error

<a name="definitions">.

Definitions

<a name="transactionstatus">

TransactionStatus

getTransactionStatus操作的有效载荷.

Name	Description	Schema
transactionStatus optional	The transaction status details.	Transaction

<a name="交易">

Transaction

交易状态详情.

Name	Description	Schema
transactionId required	响应特定交易的post请求，在'transactionId'字段中发送的唯一标识.	string
status required	交易的当前处理状态.	enum (Status
errors optional	失败交易的错误代码和信息.只在交易状态为'失败'时可用.	ErrorList

<a name="errorlist">

ErrorList

当一个请求不成功时返回的错误响应列表.

Name	Schema
errors required	< Error > array

<a name="error">

Error

当请求不成功时返回的错误响应.

Name	Description	Schema
code required	一个错误代码，用于识别所发生的错误类型.	string
message required	一个描述错误情况的信息.	string
details optional	可以帮助呼叫者理解或解决这个问题的额外细节.	string

<a name="status">

Status

交易的当前处理状态.

类型 : 枚举

Value	Description
失败	交易失败.
处理中	交易正在进行中.
成功	交易已成功完成.