獲取資料狀態

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

相關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}

註:請確保您的請求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>

示例: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"
        }
    }
}

回覆文件主體

屬性 格式 描述
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>

示例:Json, Response

{
    "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>

示例:Json, Response

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

更新日期:10/15/2018