Newegg Developer Portal

獲取資料狀態

通過給定的查詢準則獲取指定的資料請求的處理狀態。

相關URL

Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/datafeedmgmt/feeds/status?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/status?sellerid={sellerid}
Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid} Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/datafeedmgmt/feeds/status?sellerid={sellerid} Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/status?sellerid={sellerid}
Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/datafeedmgmt/feeds/status?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/status?sellerid={sellerid}

註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。

參數

名稱 是否必填? 描述
sellerid 是 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證? 請求格式 回覆格式 頻率限制
PUT 需要 XML,Json XML,Json 10,000 請求/小時

請求文件主體

屬性 是否必填? 格式 描述
IssueUser 否 String 您註冊成為新蛋賣家帳戶的郵箱地址。
OperationType 是 String 固定值:GetFeedStatusRequest
RequestID 否 String 由新蛋為每個資料請求生成請求ID的列表,如果指定請求ID,RequestType,MaxCount,RequestStatus, RequestDateFrom和RequestDateTo都可以忽略。
RequestType 否 String 可接受值:
ITEM_DATA
INVENTORY_AND_PRICE_DATA
INVENTORY_DATA
PRICE_DATA
ITEM_COUNTRY_RESTRICTION_DATA
ORDER_SHIP_NOTICE_DATA
MULTICHANNEL_ORDER_DATA
VOLUME_DISCOUNT_DATA
ITEM_WARRANTY_DATA
ITEM_CAPROP65_DATA
ITEM_CHINATAXSETTING_DATA
ITEM_SAFEGUARD_SETTING_DATA
VEHICLE_SPECIFIC_ITEM_DATA
MaxCount 否 Integer 基於每個請求類型,新蛋將輸出記錄的最大數值:

  • 默認為100
  • 如果您指定的記錄數超過100,系統也將只返回100條記錄。
RequestStatus 否 String 資料提交狀態
有效值:
ALL (Default)(所有(默認))
SUBMITTED(已提交)
IN_PROGRESS(處理中)
FINISHED(已完成)
CANCELLED(已取消)
RequestDateFrom 否 DateTime 根據請求提交起始時間查找

RequestDateTo 否 DateTime 根據請求提交結束時間查找

Schema: GetFeedStatusRequest.xsd

示例:XML, Request

PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetFeedStatusRequest</OperationType>
<RequestBody>
<GetRequestStatus>
<RequestIDList>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestIDList>
<MaxCount>100</MaxCount>
<RequestStatus>ALL</RequestStatus>
<RequestDateFrom/>
<RequestDateTo/>
</GetRequestStatus>
</RequestBody>
</NeweggAPIRequest>
PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml <NeweggAPIRequest> <OperationType>GetFeedStatusRequest</OperationType> <RequestBody> <GetRequestStatus> <RequestIDList> <RequestID>2PQCX3SPZ3QBF</RequestID> </RequestIDList> <MaxCount>100</MaxCount> <RequestStatus>ALL</RequestStatus> <RequestDateFrom/> <RequestDateTo/> </GetRequestStatus> </RequestBody> </NeweggAPIRequest>
PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest>
    <OperationType>GetFeedStatusRequest</OperationType>
    <RequestBody>
        <GetRequestStatus>
            <RequestIDList>
                <RequestID>2PQCX3SPZ3QBF</RequestID>
            </RequestIDList>
            <MaxCount>100</MaxCount>
            <RequestStatus>ALL</RequestStatus>
            <RequestDateFrom/>
            <RequestDateTo/>
        </GetRequestStatus>
    </RequestBody>
</NeweggAPIRequest>

示例:Json, Request

PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetFeedStatusRequest",
"RequestBody": {
"GetRequestStatus": {
"RequestIDList": {
"RequestID": "2PQCX3SPZ3QBF"
},
"MaxCount": "100",
"RequestStatus": "ALL"
}
}
}
PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid} Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/json Accept: application/json { "OperationType": "GetFeedStatusRequest", "RequestBody": { "GetRequestStatus": { "RequestIDList": { "RequestID": "2PQCX3SPZ3QBF" }, "MaxCount": "100", "RequestStatus": "ALL" } } }
PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "GetFeedStatusRequest",
    "RequestBody": {
        "GetRequestStatus": {
            "RequestIDList": {
                "RequestID": "2PQCX3SPZ3QBF"
            },
            "MaxCount": "100",
            "RequestStatus": "ALL"
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 獲取資料狀態操作:
True:成功
False:失敗
OperationType String 固定值:GetFeedStatusResponse
SellerID String 您在新蛋的商家編碼
RequestId String 每個資料請求的新蛋標識碼
RequestType String ITEM_DATA
INVENTORY_AND_PRICE_DATA
INVENTORY_DATA
PRICE_DATA
ITEM_COUNTRY_RESTRICTION_DATA
ORDER_SHIP_NOTICE_DATA
MULTICHANNEL_ORDER_DATA
ITEM_SUBSCRIPTION
VOLUME_DISCOUNT_DATA
ITEM_PROMOTION_DATA
ITEM_PREMIER_MARK_DATA
ITEM_WARRANTY_DATA
ITEM_CAPROP65_DATA
ITEM_CHINATAXSETTING_DATA
VEHICLE_SPECIFIC_ITEM_DATA
RequestDate String 資料提交的日期(太平洋標準時間)
RequestStatus String 資料提交的狀態
有效值:
SUBMITTED(已提交)
IN_PROGRESS(處理中)
FINISHED(已完成)
CANCELLED(已取消)
Memo String 詳細的錯誤資訊

Schema: GetFeedStatusResponse.xsd

示例:XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetFeedStatusResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>2PQCX3SPZ3QBF</RequestId>
<RequestType>ITEM_DATA</RequestType>
<RequestDate>2/22/2012 17:25:10</RequestDate>
<RequestStatus>FINISHED</RequestStatus>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
<?xml version="1.0" encoding="utf-8"?> <NeweggAPIResponse> <IsSuccess>true</IsSuccess> <OperationType>GetFeedStatusResponse</OperationType> <SellerID>A006</SellerID> <ResponseBody> <ResponseList> <ResponseInfo> <RequestId>2PQCX3SPZ3QBF</RequestId> <RequestType>ITEM_DATA</RequestType> <RequestDate>2/22/2012 17:25:10</RequestDate> <RequestStatus>FINISHED</RequestStatus> </ResponseInfo> </ResponseList> </ResponseBody> </NeweggAPIResponse>
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetFeedStatusResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <ResponseList>
            <ResponseInfo>
                <RequestId>2PQCX3SPZ3QBF</RequestId>
                <RequestType>ITEM_DATA</RequestType>
                <RequestDate>2/22/2012 17:25:10</RequestDate>
                <RequestStatus>FINISHED</RequestStatus>
            </ResponseInfo>
        </ResponseList>
    </ResponseBody>
</NeweggAPIResponse>

示例:Json, Response

{
"IsSuccess": true,
"OperationType": "GetFeedStatusResponse",
"ResponseBody": {
"ResponseList": [
{
"RequestDate": "2/22/2012 17:25:10",
"RequestId": "2PQCX3SPZ3QBF",
"RequestStatus": "FINISHED",
"RequestType": "ITEM_DATA"
}
]
},
"SellerID": "A006"
}
{ "IsSuccess": true, "OperationType": "GetFeedStatusResponse", "ResponseBody": { "ResponseList": [ { "RequestDate": "2/22/2012 17:25:10", "RequestId": "2PQCX3SPZ3QBF", "RequestStatus": "FINISHED", "RequestType": "ITEM_DATA" } ] }, "SellerID": "A006" }
{
    "IsSuccess": true,
    "OperationType": "GetFeedStatusResponse",
    "ResponseBody": {
        "ResponseList": [
            {
                "RequestDate": "2/22/2012 17:25:10",
                "RequestId": "2PQCX3SPZ3QBF",
                "RequestStatus": "FINISHED",
                "RequestType": "ITEM_DATA"
            }
        ]
    },
    "SellerID": "A006"
}

請求失敗錯誤資訊

常規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>
<?xml version="1.0" encoding="utf-8"?> <Errors> <Error> <Code>CE001</Code> <Message>SellerID cannot be null or empty</Message> </Error> </Errors>
<?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"
}
]
[ { "Code": "CE001", "Message": "SellerID cannot be null or empty" } ]
[
    {
        "Code": "CE001",
        "Message": "SellerID cannot be null or empty"
    }
]

更新日期:10/15/2018