# 概述
通过Solicitations API，您可以建立向买方发送非-关键性邀约的应用程序. 您可以获得您指定的订单可用的邀约类型列表，然后调用一个操作，为该订单向买方发送邀约. 买方不能响应由该API发送的邀约，而且这些邀约不会出现在卖方中心的消息传递部分或收件人的消息中心. Solicitations API返回根据<a href=https: //tools.ietf.org/html/draft-kelly-json-hal-08>JSON超文本应用语言 (HAL)标准.
# Version information
版本 : v1
# Operations
getSolicitationActionsForOrder
createProductReviewAndSellerFeedbackSolicitation
<a name="paths">
# 路径
<a name="getolicitationactionsfororder">
# getSolicitationActionsForOrder
GET /solicitations/v1/orders/{amazonOrderId}
# Description
返回您指定的订单可用的邀约类型列表.一个邀约类型由一个行动对象表示，其中包含一个路径和查询参数(s).您可以使用路径和参数(s)来调用一个发送邀约的操作.目前只有productReviewAndSellerFeedbackSolicitation类型可用.
使用计划：
| 速率(每秒的请求) | 突发 |
|---|---|
| 1 | 5 |
更多信息，请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | amazonOrderId required | An Amazon order identifier. This specifies the order for which you want a list of available solicitation types. | string |
| Query | marketplaceIds required | A marketplace identifier. 这指定了订单所在的市场.只能指定一个市场. Max count : 1 | <字符串>数组 |
# Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Returns hypermedia links under _links.actions key that specify which solicitation actions are allowed for the order. Headers : x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) x-amzn-RequestId (string) 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
| 400 | Request有缺失或无效的参数，不能被解析. 头信息: x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
| 403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : Unique request reference identifier. | GetSolicitationActionsForOrderResponse |
| 404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
| 413 | 请求的大小超过了最大接受大小. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)对于这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
| 415 | 请求的有效载荷是不支持的格式. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
| 429 | 请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
| 500 | 发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)对于这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
| 503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意:_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | GetSolicitationActionsForOrderResponse |
<a name="createproductreviewandsellerfeedbacksolicitation">
# createProductReviewAndSellerFeedbackSolicitation
POST /solicitations/v1/orders/{amazonOrderId}/solicitations/productReviewAndSellerFeedback
# Description
向买方发送征求卖方反馈意见和指定订单的产品评论的邀约.每个订单只能发送一条productReviewAndSellerFeedback或自由形式的主动信息.
使用计划：
| 速率(每秒的请求) | 突发 |
|---|---|
| 1 | 5 |
更多信息，请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | amazonOrderId required | An Amazon order identifier. This specifies the order for which a solicitation is sent. | string |
| Query | marketplaceIds required | A marketplace identifier. 这指定了订单所在的市场.只能指定一个市场. Max count : 1 | <字符串>数组 |
# Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | 该信息是为该订单创建的. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) x-amzn-RequestId (string) 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 400 | Request有缺失或无效的参数，无法解析. Headers: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : Unique request reference identifier. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 413 | 请求的大小超过了最大接受的大小. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)对于这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 415 | 请求的有效载荷是不支持的格式. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 429 | 请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 500 | 发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)对于这个操作._注意：_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
| 503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意:_对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) 唯一的请求参考标识符. | CreateProductReviewAndSellerFeedbackSolicitationResponse |
<a name="definitions">
# Definitions
<a name="linkobject">
# LinkObject
一个链接对象.
| Name | Description | Schema |
|---|---|---|
| href required | A 此对象的URI. | string |
| name optional | 这个对象的标识符. | string |
<a name="solicitationsaction">
# SolicitationsAction
一个包含模板名称的简单对象.
| Name | Schema |
|---|---|
| name required | string |
<a name="schema">
# Schema
一个JSON模式文件，描述了行动的预期有效载荷.这个对象可以通过<a href=http://json-schema.org/draft-04/schema>http://json-schema.org/draft-04/schema. 来验证
类型 : 对象
<a name="getolicitationactionsfororderresponse">
# GetSolicitationActionsForOrderResponse
getSolicitationActionsForOrder操作的响应模式.
| Name | Description | Schema |
|---|---|---|
| links optional | - | _links |
| embedded optional | - | _embedded |
| errors optional | A list of error responses returned when a request is unsuccessful. | ErrorList |
<a name="getolicitationactionsfororderresponse-links"> 链接
| Name | Description | Schema |
|---|---|---|
| self required | - | LinkObject |
| actions required | Eligible actions for the specified amazonOrderId. | < LinkObject> array |
<a name="getolicitationactionsfororderresponse-embedded"> embedded
| Name | Schema |
|---|---|
| actions required | < GetSolicitationActionResponse > array |
<a name="getsolicitationactionresponse">
# GetSolicitationActionResponse
描述可对订单采取的招标行动. 提供一个JSON超文本应用语言(HAL)链接到JSON模式文件，描述预期的输入.
| Name | Description | Schema |
|---|---|---|
| links optional | - | _links |
| embedded optional | - | _embedded |
| payload optional | A simple object containing the name of the template. | SolicitationsAction |
| errors optional | A list of error responses returned when a request is unsuccessful. | ErrorList |
<a name="getolicitationactionresponse-links"> 链接
| Name | Schema |
|---|---|
| self required | LinkObject |
| schema required | LinkObject |
<a name="getolicitationactionresponse-embedded"> embedded
| Name | Schema |
|---|---|
| schema optional | GetSchemaResponse |
<a name="getschemaresponse">
# GetSchemaResponse
| Name | Description | Schema |
|---|---|---|
| links optional | - | _links |
| payload optional | A JSON模式文档，描述行动的预期有效载荷.这个对象可以通过<a href=http://json-schema.org/draft-04/schema>http://json-schema.org/draft-04/schema. | Schema |
| errors optional | 当请求不成功时返回的错误响应列表. | ErrorList |
<a name="getschemaresponse-links"> 链接
| Name | Schema |
|---|---|
| self required | LinkObject |
<a name="createproductreviewandsfeedbacksolicitationresponse">
# CreateProductReviewAndSellerFeedbackSolicitationResponse
createProductReviewAndSellerFeedbackSolicitation操作的响应模式.
| Name | Description | Schema |
|---|---|---|
| errors optional | A list of error responses returned when a request is unsuccessful. | ErrorList |
<a name="errorlist">
# ErrorList
当请求不成功时返回的错误响应列表.
类型 < Error > 数组
<a name="error">
# Error
当请求不成功时返回的错误响应.
| Name | Description | Schema |
|---|---|---|
| code required | 一个错误代码，用于识别所发生的错误类型. | string |
| message required | 一个以人类可读的形式描述错误情况的信息. | string |
| details optional | 可以帮助呼叫者理解或解决这个问题的额外细节. | string |