Update rate header descriptions and sandbox extension

This commit is contained in:
Abby Menting 2021-08-30 11:18:31 -07:00
parent 36629db95f
commit e349a29c21
1 changed files with 345 additions and 271 deletions

View File

@ -1,9 +1,9 @@
{
"swagger": "2.0",
"info": {
"title": "Selling Partner API for Solicitations",
"description": "With the Solicitations API you can build applications that send non-critical solicitations to buyers. You can get a list of solicitation types that are available for an order that you specify, then call an operation that sends a solicitation to the buyer for that order. Buyers cannot respond to solicitations sent by this API, and these solicitations do not appear in the Messaging section of Seller Central or in the recipient's Message Center. The Solicitations API returns responses that are formed according to the <a href=https://tools.ietf.org/html/draft-kelly-json-hal-08>JSON Hypertext Application Language</a> (HAL) standard.",
"version": "v1",
"title": "Selling Partner API for Solicitations",
"contact": {
"name": "Selling Partner API Developer Support",
"url": "https://sellercentral.amazon.com/gp/mws/contactus.html"
@ -26,45 +26,37 @@
"paths": {
"/solicitations/v1/orders/{amazonOrderId}": {
"get": {
"tags": [
"solicitations"
],
"description": "Returns a list of solicitation types that are available for an order that you specify. A solicitation type is represented by an actions object, which contains a path and query parameter(s). You can use the path and parameter(s) to call an operation that sends a solicitation. Currently only the productReviewAndSellerFeedbackSolicitation solicitation type is available.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 5 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
"operationId": "getSolicitationActionsForOrder",
"tags": ["solicitations"],
"parameters": [
{
"name": "amazonOrderId",
"in": "path",
"description": "An Amazon order identifier. This specifies the order for which you want a list of available solicitation types.",
"required": true,
"type": "string"
},
{
"name": "marketplaceIds",
"in": "query",
"description": "A marketplace identifier. This specifies the marketplace in which the order was placed. Only one marketplace can be specified.",
"required": true,
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
}
],
"responses": {
"200": {
"description": "Returns hypermedia links under the _links.actions key that specify which solicitation actions are allowed for the order.",
"headers": {
"x-amzn-requestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"amazonOrderId": {
"value": "123-1234567-1234567"
},
"marketplaceIds": {
"value": ["ATVPDKIKX0DER"]
}
}
},
"response": {
"_links": {
"actions": [
{
"href": "/solicitations/v1/orders/123-1234567-1234567/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER",
"name": "productReviewAndSellerFeedback"
}
],
"self": {
"href": "/solicitations/v1/orders/123-1234567-1234567?marketplaceIds=ATVPDKIKX0DER"
}
}
}
}
],
"examples": {
"application/hal+json": {
"_links": {
@ -92,283 +84,367 @@
}
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"amazonOrderId": {
"value": "123-1234567-1234567"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"_links": {
"actions": [
{
"href": "/solicitations/v1/orders/123-1234567-1234567/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER",
"name": "productReviewAndSellerFeedback"
}
],
"self": {
"href": "/solicitations/v1/orders/123-1234567-1234567?marketplaceIds=ATVPDKIKX0DER"
}
}
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/GetSolicitationActionsForOrderResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
},
"parameters": [
{
"name": "amazonOrderId",
"type": "string",
"in": "path",
"required": true,
"description": "An Amazon order identifier. This specifies the order for which you want a list of available solicitation types."
},
{
"name": "marketplaceIds",
"type": "array",
"in": "query",
"required": true,
"description": "A marketplace identifier. This specifies the marketplace in which the order was placed. Only one marketplace can be specified.",
"items": {
"type": "string"
},
"maxItems": 1
}
]
}
}
},
"/solicitations/v1/orders/{amazonOrderId}/solicitations/productReviewAndSellerFeedback": {
"post": {
"tags": [
"solicitations"
],
"description": "Sends a solicitation to a buyer asking for seller feedback and a product review for the specified order. Send only one productReviewAndSellerFeedback or free form proactive message per order.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 5 |\n\nFor more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
"operationId": "createProductReviewAndSellerFeedbackSolicitation",
"tags": ["solicitations"],
"responses": {
"201": {
"description": "The message was created for the order.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"amazonOrderId": {
"value": "123-1234567-1234567"
}
}
},
"response": {}
}
]
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
}
}
},
"parameters": [
{
"name": "amazonOrderId",
"type": "string",
"in": "path",
"description": "An Amazon order identifier. This specifies the order for which a solicitation is sent.",
"required": true,
"description": "An Amazon order identifier. This specifies the order for which a solicitation is sent."
"type": "string"
},
{
"name": "marketplaceIds",
"type": "array",
"in": "query",
"required": true,
"description": "A marketplace identifier. This specifies the marketplace in which the order was placed. Only one marketplace can be specified.",
"required": true,
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
}
]
],
"responses": {
"201": {
"description": "The message was created for the order.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"amazonOrderId": {
"value": "123-1234567-1234567"
}
}
},
"response": {}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/CreateProductReviewAndSellerFeedbackSolicitationResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
}
}
},
"definitions": {
"LinkObject": {
"description": "A Link object.",
"type": "object",
"required": [
"href"
],
"properties": {
"href": {
"type": "string",
@ -379,29 +455,26 @@
"description": "An identifier for this object."
}
},
"required": [
"href"
]
"description": "A Link object."
},
"SolicitationsAction": {
"description": "A simple object containing the name of the template.",
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
]
"description": "A simple object containing the name of the template."
},
"Schema": {
"type": "object",
"description": "A JSON schema document describing the expected payload of the action. This object can be validated against <a href=http://json-schema.org/draft-04/schema>http://json-schema.org/draft-04/schema</a>.",
"additionalProperties": true
"additionalProperties": {}
},
"GetSolicitationActionsForOrderResponse": {
"description": "The response schema for the getSolicitationActionsForOrder operation.",
"type": "object",
"properties": {
"_links": {
@ -411,16 +484,16 @@
"$ref": "#/definitions/LinkObject"
},
"actions": {
"description": "Eligible actions for the specified amazonOrderId.",
"type": "array",
"description": "Eligible actions for the specified amazonOrderId.",
"items": {
"$ref": "#/definitions/LinkObject"
}
}
},
"required": [
"self",
"actions"
"actions",
"self"
]
},
"_embedded": {
@ -440,10 +513,10 @@
"errors": {
"$ref": "#/definitions/ErrorList"
}
}
},
"description": "The response schema for the getSolicitationActionsForOrder operation."
},
"GetSolicitationActionResponse": {
"description": "Describes a solicitation action that can be taken for an order. Provides a JSON Hypertext Application Language (HAL) link to the JSON schema document that describes the expected input.",
"type": "object",
"properties": {
"_links": {
@ -457,8 +530,8 @@
}
},
"required": [
"self",
"schema"
"schema",
"self"
]
},
"_embedded": {
@ -475,7 +548,8 @@
"errors": {
"$ref": "#/definitions/ErrorList"
}
}
},
"description": "Describes a solicitation action that can be taken for an order. Provides a JSON Hypertext Application Language (HAL) link to the JSON schema document that describes the expected input."
},
"GetSchemaResponse": {
"type": "object",
@ -500,42 +574,42 @@
}
},
"CreateProductReviewAndSellerFeedbackSolicitationResponse": {
"description": "The response schema for the createProductReviewAndSellerFeedbackSolicitation operation.",
"type": "object",
"properties": {
"errors": {
"$ref": "#/definitions/ErrorList"
}
}
},
"description": "The response schema for the createProductReviewAndSellerFeedbackSolicitation operation."
},
"ErrorList": {
"description": "A list of error responses returned when a request is unsuccessful.",
"type": "array",
"description": "A list of error responses returned when a request is unsuccessful.",
"items": {
"$ref": "#/definitions/Error"
}
},
"Error": {
"description": "Error response returned when the request is unsuccessful.",
"properties": {
"code": {
"description": "An error code that identifies the type of error that occurred.",
"type": "string"
},
"message": {
"description": "A message that describes the error condition in a human-readable form.",
"type": "string"
},
"details": {
"description": "Additional details that can help the caller understand or fix the issue.",
"type": "string"
}
},
"type": "object",
"required": [
"code",
"message"
],
"type": "object"
"properties": {
"code": {
"type": "string",
"description": "An error code that identifies the type of error that occurred."
},
"message": {
"type": "string",
"description": "A message that describes the error condition in a human-readable form."
},
"details": {
"type": "string",
"description": "Additional details that can help the caller understand or fix the issue."
}
},
"description": "Error response returned when the request is unsuccessful."
}
}
}
}