征求意见的API v1用例指南

亚马逊SPAPI

API版本: v1

# 什么是Solicitations API?

Selling Partner API for Solicitations (Solicitations API)帮助你建立应用程序,让卖家向买家发送一致的、高质量的邀约.卖家可以通过发送一个基于模板的电子邮件来要求产品评论和卖家反馈.

# Tutorial: 征求订单的反馈意见

本教程告诉您如何为一个订单征求产品评论和卖家反馈.您首先验证一个订单是否可供征求意见,然后创建征求意见请求.

先决条件

要完成本教程,您需要

# 步骤1.验证一个订单是否可用于招标

调用getSolicitationActionsForOrder (opens new window)操作,传递以下参数

路径参数

Parameter Description Required
amazonOrderId

一个亚马逊订单的标识符.这指定了你想要的可用招标列表的订单 类型.

类型:字符串

是的

查询参数

Parameter Description Required
marketplaceIds

A marketplace identifier.这指定了下单的市场.只有一个市场 可以被指定.

Type: array[String]

是的

# Request example

GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777
  .marketplaceIds=ATVPDKIKX0DER
1
2

# Response examples

没有招标行动时的响应示例

{
  "_links": {
    "行动": [],
    "自己"{
      "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
    }
  },
  "_embedded": {
    "行动": []
  }
}
1
2
3
4
5
6
7
8
9
10
11

有招标行动时的响应实例

{
  "_links": {
    "行动": [
      {
        "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback? marketplaceIds=ATVPDKIKX0DER"
        "name": "productReviewAndSellerFeedback"
      }
    ],
    "自己"{
      "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
    }
  },
  "_embedded": {
    "行动": [
      {
        "_链接": {
          "schema": {
            "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema"
            "name": "productReviewAndSellerFeedback"
          },
          "自己"{
            "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback? marketplaceIds=ATVPDKIKX0DER"
            "name": "productReviewAndSellerFeedback"
          }
        },
        "_embedded": {
          "schema": {
            "_链接": {
              "自我"{
                "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema"
                "name": "productReviewAndSellerFeedback"
              }
            },
            "类型": "对象",
            "名称": "productReviewAndSellerFeedback",
            "标题": "要求卖家反馈和产品评论"
            "描述": "请求卖家反馈和产品评论"
            "属性": {},
            "需要": [],
            "$schema": "http://json-schema.org/draft-04/schema#",
            "x-ui-hidden": true
          }
        },
        "name": "productReviewAndSellerFeedback",
        "标题": "要求卖家反馈和产品评论"
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# 步骤2.创建一个产品评论征求信息

如果productReviewAndSellerFeedback行动被列在响应中,调用createProductReviewAndSellerFeedbackSolicitation (opens new window)操作,传递以下参数

路径参数

的参数
Parameter Description Required
amazonOrderId

一个亚马逊订单的标识符.这指定了发送招标的订单.

类型: string

是的

查询参数

Parameter Description Required
marketplaceIds

A marketplace identifier.这指定了下单的市场.只有一个市场 可以被指定.

Type: array[String]

是的

# Request example

POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback
  .marketplaceIds=ATVPDKIKX0DER
1
2

# Response examples

合格订单的响应示例

{}
1

不符合条件的订单的响应示例

{
  "errors": [
    {
      "代码": "Unauthorized",
      "message": "所请求的招标对这个amazonOrderId.来说是不可用的"
      "详情": ""
    }
  ]
}
1
2
3
4
5
6
7
8
9
Last Updated: 2022/10/20 下午11:58:42