服務程式狀態

新蛋商城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
  • servicemgmtreportmgmt
  • 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