POST已開放bar-code-query

商品条形码查询

根据商品条形码查询商品的详细信息

接入文件

根据商品条形码查询商品的详细信息

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

Shell 示例Python 示例Go 示例Java 示例PHP 示例

Shell 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/bar-code/query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/bar-code/query"
payload = {}

headers = {
    "Content-Type": "application/json",
    "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}

response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())

Go 示例

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/bar-code/query"
    payload := []byte("{}")

    req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

請求示例

{}

響應示例

{
  "code": 200,
  "data": {
    "gw": {
      "type": "string",
      "example": "",
      "description": "毛重"
    },
    "nw": {
      "type": "string",
      "example": "",
      "description": "净重"
    },
    "qs": {
      "type": "string",
      "example": "",
      "description": "生产许可证号"
    },
    "gpc": {
      "type": "string",
      "example": "",
      "description": "gpc分类代码"
    },
    "img": {
      "type": "string",
      "example": "",
      "description": "图片，24小时有效"
    },
    "ycg": {
      "type": "string",
      "example": "",
      "description": "原产地(可能无此参数信息)"
    },
    "code": {
      "type": "string",
      "example": "69********432",
      "description": "条形码"
    },
    "note": {
      "type": "string",
      "example": "备注：经查，该厂商识别代码已在中国物品编码中心注册，但xxxxx",
      "description": "备注信息"
    },
    "spec": {
      "type": "string",
      "example": "迷你型",
      "description": "规格"
    },
    "depth": {
      "type": "string",
      "example": "",
      "description": "深"
    },
    "hight": {
      "type": "string",
      "example": "",
      "description": "高"
    },
    "price": {
      "type": "string",
      "example": "",
      "description": "参考价格(单位:元)"
    },
    "width": {
      "type": "string",
      "example": "",
      "description": "宽"
    },
    "gpcType": {
      "type": "string",
      "example": "",
      "description": "gpc分类名称"
    },
    "imgList": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "example": [],
      "description": "条码中心图片列表"
    },
    "keyword": {
      "type": "string",
      "example": "",
      "description": "关键词"
    },
    "sptmImg": {
      "type": "string",
      "example": "",
      "description": "条码图片"
    },
    "manuName": {
      "type": "string",
      "example": "xxxx集团有限公司",
      "description": "厂商"
    },
    "goodsName": {
      "type": "string",
      "example": "xxxx纯品纸手帕",
      "description": "商品名称"
    },
    "goodsType": {
      "type": "string",
      "example": "造纸原料和纸制品>>纸制品>>个人纸制品>>纸巾",
      "description": "商品分类"
    },
    "trademark": {
      "type": "string",
      "example": "清风",
      "description": "品牌"
    },
    "description": {
      "type": "string",
      "example": "",
      "description": "形态描述"
    },
    "manuAddress": {
      "type": "string",
      "example": "江苏省苏州市苏州工业xxxx",
      "description": "厂商地址"
    }
  },
  "message": "success"
}

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
code	number	200
data	object	{...}
data.gw	object	{...}
data.gw.type	string	string
data.gw.example	string
data.gw.description	string	毛重
data.nw	object	{...}
data.nw.type	string