新蛋商城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服務,您需要提供如下清單的認證資訊。

名稱 是否必填? 描述
Authorization 格式:Authorization:{authorization}

API Key:新蛋商城integration team制訂給您的唯一的API Key

Secret key 格式:Secretkey:{secretkey}

Secret Key:新蛋商城integration team制訂給您的唯一的金鑰

示例: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認證失敗

錯誤代碼 描述
InvalidConsumerKey 提供的使用者金鑰是錯誤的或者是無效的

示例: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 服務以提供商家集成服務,您必須:

  • 通過聯繫商城Integration Team完成服務商註冊
  • 獲取協力廠商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