新蛋商城API端点和时间标准

新蛋商城API的端点是区分大小写的。请确保您的请求URL(不包括Seller ID)全都使用小写。并且此URL不能包含任何空格和换行符。Seller ID除外,可以大写。

Newegg.com,Neweggbusiness.com,Newegg.ca三个平台的端点/URLs

在提交不同平台的请求时,请使用正确的端点或者URLs:

Newegg.com: https://api.newegg.com/marketplace/
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/
Newegg.ca: https://api.newegg.com/marketplace/can/

示例:XML,Request

POST 
https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid=A006
Authorization: 727ddc067f4d115bd544aff46bc15634
SecretKey: 1B6B1383-01D1-4A1E-BA53-05DECE9BD765
Content-Type: application/xml
Accept: application/xml

认证失败错误信息

错误代码 描述
InvalidConsumerKey The provided consumer key is incorrect or invalid

提供的用户密钥是错误的或是无效的

InvalidToken Seller ID is null

商家编号为空值

InvalidToken Secret Key is null

密钥为空值

InvalidToken Invalid Secret Key

无效的密钥

AccessDenied The specified seller ID is invalid or you do not have authorization from this seller

指定的商家编号无效或者您没有该商家的授权

AccessDenied The API services for this seller account has been deactivated

该商家账户的API服务已停用

示例:XML,Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
  <Error>
    <Code>InvalidToken</Code>
    <Message>Secret Key is null.</Message>
  </Error>
</Errors>

示例:Json,Response

[
    {
        "Code": "InvalidConsumerKey",
        "Message": "The provided consumer key is malformed or otherwise invalid."
    }
]

端点/URLs须区分大小写

新蛋商城API URLs是区分大小写的。 请确保您的请求URL(不包括Seller ID)全都使用小写。并且URL不能包含任何空格或者换行符。Seller ID除外,可以大写。

Newegg.com示例

https://api.newegg.com/marketplace/contentmgmt/item
https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid={sellerid}
https://api.newegg.com/marketplace/contentmgmt/item/price?sellerid={sellerid}
https://api.newegg.com/marketplace/contentmgmt/item/inventoryandprice?sellerid={sellerid}
https://api.newegg.com/marketplace/ordermgmt/orderstatus
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}

Neweggbusiness.com示例

https://api.newegg.com/marketplace/b2b/contentmgmt/item
https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventory?sellerid={sellerid}
https://api.newegg.com/marketplace/b2b/contentmgmt/item/price?sellerid={sellerid}
https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventoryandprice?sellerid={sellerid}
https://api.newegg.com/marketplace/b2b/ordermgmt/orderstatus
https://api.newegg.com/marketplace/b2b/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}

Newegg.ca示例

https://api.newegg.com/marketplace/can/contentmgmt/item 
https://api.newegg.com/marketplace/can/contentmgmt/item/inventory?sellerid={sellerid}
https://api.newegg.com/marketplace/can/contentmgmt/item/price?sellerid={sellerid}
https://api.newegg.com/marketplace/can/contentmgmt/item/inventoryandprice?sellerid={sellerid}
https://api.newegg.com/marketplace/can/ordermgmt/orderstatus
https://api.newegg.com/marketplace/can/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}

入站连接的TLS需求

与新蛋商城API端点的入站连接需要TLS 1.2版本或者更高。

注: TLS 1.1版本 已在10/01/2020后停用

太平洋标准时间(美国西部标准时间)要求

新蛋商城API服务要求日期与时间字段在所有的请求和回复内容中都显示为美国西部标准时间(太平洋标准时间)。请确认在所有的文件和请求中,日期与时间字段都使用的是美国西部标准时间(太平洋标准时间)。

更新日期:08/28/2020