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服务器故障

请求参数

示例代码

返回响应