服务程序状态

新蛋商城API在每个主要服务功能中提供一个接口来检查您所调用的服务是否可用。每个主要的服务功能都须列在参数部分的domain字段描述中。返回每个主要功能运行状态的可用性。

相关URL

Newegg.com: https://api.newegg.com/marketplace/{domain}/servicestatus?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/{domain}/servicestatus?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/{domain}/servicestatus?sellerid={sellerid}

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填 描述
domain 是 主要的服务功能选项：

  • contentmgmt
  • ordermgmt
  • datafeedmgmt
  • servicemgmt
  • reportmgmt
  • sellermgmt
  • sbnmgmt
  • shippingservice
Sellerid 是 您在新蛋商城的商家编号

相关请求信息

HTTP方法 是否需要认证？ 请求格式 回复格式 频率限制？
GET 需要 XML, Json XML, Json 1000 请求/小时

示例：XML，Request

GET https://api.newegg.com/marketplace/contentmgmt/servicestatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

示例：Json，Request

GET https://api.newegg.com/marketplace/contentmgmt/servicestatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

回复文件主体

属性 格式 描述
IsSuccess String 用于确认请求服务是否成功，返回true或false
OperationType String 固定值：GetServiceStatus
SellerID String 您的商家编号
Status Integer 0. Service unavailable（服务不可用）

1. Service available（服务可用）
Timestamp String 请求时间（太平洋标准时间）
Message String 当服务不可用 (status=0)时，这个字段将会提供详细解释

Schema: GetSellerAccountStatusResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetServiceStatus</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <Status>1</Status>
        <Timestamp>2/14/2012 9:42:46</Timestamp>
    </ResponseBody>
</NeweggAPIResponse>

示例：Json，Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "OperationType": "GetServiceStatus",
        "SellerID": "A006",
        "ResponseBody": {
            "Status": "0",
            "Timestamp": "2/15/2012 2:50:38",
            "Message": "The service is unavailable or experiencing extremely high error rates."
        }
    }
}

请求失败错误信息

常规HTTP错误回复，请参考失败响应错误代码列表

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CE001</Code>
        <Message>SellerID cannot be null or empty</Message>
    </Error>
</Errors>

示例：Json，Response

[
    {
        "Code": "CE001",
        "Message": "SellerID cannot be null or empty"
    }
]

更新日期：10/15/2018