新蛋商城API 注册和认证

API服务注册

如果您需要使用新蛋商城的API 服务，请参考API访问授权-请求API凭证来获取您的新蛋API认证。

• 获取您的API key和Secret key – 一旦您申请API认证的请求被批准，并成功创建账户，新蛋商城的Integration team将会给您发一对API Key和Secret Key。为了能够使用新蛋商城API服务，您必须要在每个功能提供API Key和Secret Key来作为认证。
• 将访问权限授权给第三方服务商 – 如果您想要由您的第三方服务商使用新蛋商城的API 服务，在您的授权下，我们可以分配一对额外的API Key和Secret Key给服务商。为了证明是由您们授权来使用新蛋商城API 服务，第三方服务商必须提供这个额外分配的API Key和Secret Key。

重要！我们强烈建议不要让任何未被授权的个人或者第三方服务商使用您的原始API Key和Secret Key。任何拥有这个信息的人都可以和您一样使用新蛋商城的API 服务。

新蛋商城API认证

为了使用新蛋商城API服务，您需要提供如下列表的认证信息。

示例：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

示例：Json，Request

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

认证失败错误信息

API key认证失败:

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>InvalidConsumerKey</Code>
        <Message>The provided consumer key is incorrect or invalid.</Message>
    </Error>
</Errors>

示例：Json，Response

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

第三方服务商授权须知

如果您是第三方服务商或集成合作人想要使用新蛋商城API 服务以提供商家集成服务，您必须：

• 通过联系商城集成部门完成服务商注册
• 获取第三方API Key
• 从商家处获取商家编号Seller ID和Secret Key，商家将会授权您使用新蛋商城API服务来为他们整合信息。（商家和第三方服务商可以联系新蛋商城以获取这部分信息）
• 在HTTP请求/回复网址的header添加API Key和Secret Key，写明商家编号（Seller ID），并确认Secret Key是来自于正确的商家

例如下面的例子，Secret Key必须与商家编号 （Seller ID）A001相对应。

示例：XML，Request

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

示例：Json，Request

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

否则，系统将会因为无效的Secret Key而返回下列错误信息。

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>InvalidToken</Code>
        <Message>Invalid secret key.</Message>
    </Error>
</Errors>

示例：Json，Response

[
    {
        "Code": "InvalidToken",
        "Message": "Invalid secret key."
    }
]

更新日期：10/15/2018