getServiceJobs

获取指定过滤查询的服务作业详细信息。

使用计划：

速率（每秒请求数）	峰值
10	40

x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制（如果可用）。上面的表格指示了此操作的默认速率和峰值值。业务需求要求更高吞吐量的销售合作伙伴，可能会看到比这里显示的更高的速率和峰值值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Query 参数

serviceOrderIds

array[string]

可选

要执行的查询的服务订单 ID 列表。支持的最大值为 20。

>= 1 items<= 20 items

serviceJobStatus

array[string]

可选

一个或多个工作状态的列表，以便筛选工作列表。

枚举值:

NOT_SERVICEDCANCELLEDCOMPLETEDPENDING_SCHEDULENOT_FULFILLABLEHOLDPAYMENT_DECLINED

pageToken

string

可选

在您之前请求的响应中返回的字符串。

pageSize

integer

可选

一个非负整数，指示要在列表中返回的最大作业数量，值必须在 1 到 20 之间。默认值为 20。

>= 1<= 20

默认值:

sortField

enum<string>

可选

对您想要对输出进行排序的字段进行排序。

枚举值:

JOB_DATEJOB_STATUS

sortOrder

enum<string>

可选

您想执行的查询的排序顺序。

枚举值:

ASCDESC

createdAfter

string

可选

用于选择在指定时间之后创建的工作的日期。必须采用 ISO 8601 格式。如果未指定 LastUpdatedAfter，则必需。指定 CreatedAfter 和 LastUpdatedAfter 两者会返回错误。

createdBefore

string

可选

用于选择在指定时间之前或之前创建的工作的日期。必须采用 ISO 8601 格式。

lastUpdatedAfter

string

可选

用于选择在指定时间更新的工作的日期。必须采用ISO 8601格式。如果未指定createdAfter，则为必需。指定CreatedAfter和LastUpdatedAfter两者将返回错误。

lastUpdatedBefore

string

可选

用于选择在指定时间之前或之时更新的工作的日期。必须采用ISO 8601格式。

scheduleStartDate

string

可选

用于过滤在指定时间或之后的职位安排的日期。必须采用ISO 8601格式。安排结束日期不得早于安排开始日期。

scheduleEndDate

string

可选

用于筛选在指定时间之前或等于该时间的工作计划的日期。必须采用 ISO 8601 格式。计划结束日期不得早于计划开始日期。

marketplaceIds

array[string]

必需

用于选择在指定市场中发布的职位。

<= 1 items

asins

array[string]

可选

亚马逊标准识别编号（ASIN）物品列表。支持的最大值为20。

>= 1 items<= 20 items

requiredSkills

array[string]

可选

一套定义明确的相关知识、技能、经验、工具、材料和工作流程，通常用于一组产品和/或服务场景的服务交付。支持的最大值为20。

>= 1 items<= 20 items

storeIds

array[string]

可选

亚马逊定义的区域范围标识符列表。支持的最大值为50。

>= 1 items<= 50 items

返回响应

🟢200成功

application/json

成功响应。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`getServiceJobs` 操作的响应模式。

payload

object (JobListing)

可选

getServiceJobs 操作的有效负载。

totalResultSize

integer

可选

查询结果的总结果大小。

nextPageToken

string

可选

用于将信息传递到下一个请求的生成字符串。如果返回了 nextPageToken，请将 nextPageToken 的值传递给 pageToken 以获取下一个结果。

previousPageToken

string

可选

一个生成的字符串，用于将信息传递给您的下一个请求。如果返回previousPageToken，请将previousPageToken的值传递给pageToken以获取上一页的结果。

jobs

array[object (ServiceJob) {14}]

可选

提供输入的工作详情列表。

errors

array[object (Error) {4}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

一种以人类可读的形式描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

errorLevel

enum<string>

错误类型。

可选

枚举值:

ERRORWARNING

示例

{
  "payload": {
    "totalResultSize": 0,
    "nextPageToken": "string",
    "previousPageToken": "string",
    "jobs": [
      {
        "createTime": "2019-08-24T14:15:22Z",
        "serviceJobId": "string",
        "serviceJobStatus": "NOT_SERVICED",
        "scopeOfWork": {
          "asin": "string",
          "title": "string",
          "quantity": 0,
          "requiredSkills": [
            "string"
          ]
        },
        "seller": {
          "sellerId": "string"
        },
        "serviceJobProvider": {
          "serviceJobProviderId": "string"
        },
        "preferredAppointmentTimes": [
          {
            "startTime": "2019-08-24T14:15:22Z",
            "durationInMinutes": 1
          }
        ],
        "appointments": [
          {
            "appointmentId": "string",
            "appointmentStatus": "ACTIVE",
            "appointmentTime": {
              "startTime": "2019-08-24T14:15:22Z",
              "durationInMinutes": 1
            },
            "assignedTechnicians": [
              {
                "technicianId": "string",
                "name": "string"
              }
            ],
            "rescheduledAppointmentId": "string",
            "poa": {
              "appointmentTime": {
                "startTime": "2019-08-24T14:15:22Z",
                "durationInMinutes": 1
              },
              "technicians": [
                {
                  "technicianId": "string",
                  "name": "string"
                }
              ],
              "uploadingTechnician": "string",
              "uploadTime": "2019-08-24T14:15:22Z",
              "poaType": "NO_SIGNATURE_DUMMY_POS"
            }
          }
        ],
        "serviceOrderId": "string",
        "marketplaceId": "string",
        "storeId": "string",
        "buyer": {
          "buyerId": "string",
          "name": "string",
          "phone": "string",
          "isPrimeMember": true
        },
        "associatedItems": [
          {
            "asin": "string",
            "title": "string",
            "quantity": 0,
            "orderId": "string",
            "itemStatus": "ACTIVE",
            "brandName": "string",
            "itemDelivery": {
              "estimatedDeliveryDate": "2019-08-24T14:15:22Z",
              "itemDeliveryPromise": {
                "startTime": "2019-08-24T14:15:22Z",
                "endTime": "2019-08-24T14:15:22Z"
              }
            }
          }
        ],
        "serviceLocation": {
          "serviceLocationType": "IN_HOME",
          "address": {
            "name": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "city": "string",
            "county": "string",
            "district": "string",
            "stateOrRegion": "string",
            "postalCode": "string",
            "countryCode": "string",
            "phone": "string"
          }
        }
      }
    ]
  },
  "errors": [
    {
      "code": "string",
      "message": "string",
      "details": "string",
      "errorLevel": "ERROR"
    }
  ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应