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