Medicine Barcode Lookup API | Request & Response Fields | ToolKK

POSTPublicdrug-barcode-check

Medicine Barcode Lookup API

Enter the numeric barcode printed on a medicine package to retrieve third-party records such as the product name, approval number, manufacturer, ingredients, dosage, contraindications, and precautions.

Documentation

Returns third-party medicine records for a package barcode. It does not replace the physical leaflet, clinical advice, or pharmacist guidance and cannot authenticate a medicine.

Request Example

{
  "code": "6901234567890"
}

Response Example

{
  "code": "6901234567890",
  "name": "示例药品",
  "approval": "国药准字示例",
  "manuName": "示例生产企业",
  "spec": "10mg×12片",
  "basis": "示例主要成分"
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	6901234567890

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	6901234567890
name	string	示例药品
approval	string	国药准字示例
manuName	string	示例生产企业
spec	string	10mg×12片
basis	string	示例主要成分

Shell Example

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/drug-barcode-check' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "code": "6901234567890"\n}'

Python Example

import os
import requests

url = "https://openapi.toolkk.com/v1/drug-barcode-check"
payload = {
  "code": "6901234567890"
}

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 Example

package main

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

func main() {
    endpoint := "https://openapi.toolkk.com/v1/drug-barcode-check"
    payload := []byte("{\n  \"code\": \"6901234567890\"\n}")

    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))
}

Java Example

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ToolkkExample {
    public static void main(String[] args) throws Exception {
        String payload = "{\n  \"code\": \"6901234567890\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/drug-barcode-check"))
            .method("POST", HttpRequest.BodyPublishers.ofString(payload))
            .header("Content-Type", "application/json")
            .header("X-API-Key", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

PHP Example

<?php

$endpoint = 'https://openapi.toolkk.com/v1/drug-barcode-check';
$payload = "{\n  \"code\": \"6901234567890\"\n}";

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: YOUR_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);
echo $response;