Verlauf

Endpunkte für Klassifizierungsverlauf – durchsuchen, filtern und Details Ihrer vergangenen Klassifizierungen abrufen.

Die Verlauf-Endpunkte ermöglichen es Ihnen, alle Ihre vergangenen Klassifizierungen zu durchsuchen und zu filtern. Jede Klassifizierung, die über die API vorgenommen wird, wird automatisch aufgezeichnet und ist zugänglich.

Klassifizierungsverlauf auflisten

GET/v1/classify/history

Abfrageparameter

Parameter	Typ	Standard	Beschreibung
`page`	`number`	`1`	Seitenzahl
`per_page`	`number`	`20`	Ergebnisse pro Seite (max. 50)
`from`	`string` (ISO 8601)	-	Startdatum (einschließlich)
`to`	`string` (ISO 8601)	-	Enddatum (einschließlich)
`hs`	`string`	-	Filter nach HS-Code (Präfix akzeptiert, z.B. `8518`)
`status`	`string`	-	Filter nach Status: `completed`, `failed`
`source`	`string`	-	Filter nach Quelle: `api`, `web`, `batch`
`all_keys`	`boolean`	`false`	Einschluss von Klassifizierungen aller API-Schlüssel in der Organisation

Beispielanfrage

curl "https://api.thetradehub.eu/v1/classify/history?page=1&per_page=10&status=completed&from=2026-02-01T00:00:00Z" \
  -H "X-API-Key: th_live_your_api_key"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_your_api_key"},
)

response = client.get("/v1/classify/history", params={
    "page": 1,
    "per_page": 10,
    "status": "completed",
    "from": "2026-02-01T00:00:00Z",
})

data = response.json()
print(f"Total: {data['total']} Klassifizierungen")
for item in data["items"]:
    hs = item["result"]["classification"]["rankings"][0]["hs_code"]
    print(f"  {item['id']} - {hs} - {item['created_at']}")

const params = new URLSearchParams({
  page: "1",
  per_page: "10",
  status: "completed",
  from: "2026-02-01T00:00:00Z",
});

const response = await fetch(
  `https://api.thetradehub.eu/v1/classify/history?${params}`,
  { headers: { "X-API-Key": "th_live_your_api_key" } }
);

const data = await response.json();
console.log(`Total: ${data.total} Klassifizierungen`);
for (const item of data.items) {
  const hs = item.result.classification.rankings[0].hs_code;
  console.log(`  ${item.id} - ${hs} - ${item.created_at}`);
}

Antwort

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "completed",
      "content": "Kabellose Bluetooth-Kopfhörer",
      "result": {
        "classification": {
          "rankings": [
            {
              "rank": 1,
              "hs_code": "8518.30.00",
              "description": "Kopfhörer und Ohrhörer",
              "confidence": 0.94
            }
          ]
        }
      },
      "source": "api",
      "api_key_name": "Production Key",
      "created_at": "2026-02-24T10:30:00Z"
    }
  ],
  "total": 156,
  "page": 1,
  "per_page": 10,
  "pages": 16
}

Struktur der paginierten Antwort

Feld	Typ	Beschreibung
`items`	`object[]`	Liste der Klassifizierungen
`total`	`number`	Gesamtanzahl der Ergebnisse
`page`	`number`	Aktuelle Seite
`per_page`	`number`	Ergebnisse pro Seite
`pages`	`number`	Gesamtanzahl der Seiten

Details einer Klassifizierung abrufen

GET/v1/classify/history/{log_id}

Pfadparameter

Parameter	Typ	Beschreibung
`log_id`	`string` (UUID)	Klassifizierungskennung

Beispielanfrage

curl https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: th_live_your_api_key"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_your_api_key"},
)

response = client.get("/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890")
log = response.json()

print(f"Produkt: {log['content']}")
print(f"HS-Code: {log['result']['classification']['rankings'][0]['hs_code']}")
print(f"Vertrauenswürdigkeit: {log['result']['classification']['rankings'][0]['confidence']}")

const response = await fetch(
  "https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  { headers: { "X-API-Key": "th_live_your_api_key" } }
);

const log = await response.json();
console.log(`Produkt: ${log.content}`);
console.log(`HS-Code: ${log.result.classification.rankings[0].hs_code}`);
console.log(`Vertrauenswürdigkeit: ${log.result.classification.rankings[0].confidence}`);

Antwort

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "content": "Kabellose Bluetooth-Kopfhörer mit aktiver Geräuschunterdrückung",
  "image_urls": ["https://example.com/product/headphones.jpg"],
  "locale": "en",
  "result": {
    "classification": {
      "rankings": [
        {
          "rank": 1,
          "hs_code": "8518.30.00",
          "description": "Kopfhörer und Ohrhörer",
          "confidence": 0.94,
          "gri_justification": "GIR 1 - Das Produkt ist speziell durch die Position 8518 abgedeckt...",
          "validated": true
        }
      ]
    },
    "text": "Basierend auf EU vZTA-Beschlüssen und TARIC-Nomenklatur..."
  },
  "source": "api",
  "api_key_name": "Production Key",
  "session_id": "sess_abc123",
  "created_at": "2026-02-24T10:30:00Z",
  "updated_at": "2026-02-24T10:30:05Z"
}

Erweiterte Filter

Filter nach HS-Code

Der Parameter hs akzeptiert ein HS-Code-Präfix. Er filtert Klassifizierungen, deren bestes Ergebnis mit diesem Präfix beginnt:

# Alle Produkte, die unter Kapitel 85 (elektrische Maschinen und Geräte) klassifiziert sind
curl "https://api.thetradehub.eu/v1/classify/history?hs=85" \
  -H "X-API-Key: th_live_your_api_key"

# Spezifische Position 8518 (Mikrofone, Lautsprecher, Kopfhörer)
curl "https://api.thetradehub.eu/v1/classify/history?hs=8518" \
  -H "X-API-Key: th_live_your_api_key"

Filter nach Datumsbereich

Kombinieren Sie from und to, um den Zeitraum einzuschränken. Die Daten müssen im ISO 8601-Format sein:

# Klassifizierungen aus Februar 2026
curl "https://api.thetradehub.eu/v1/classify/history?from=2026-02-01T00:00:00Z&to=2026-02-28T23:59:59Z" \
  -H "X-API-Key: th_live_your_api_key"

Sichtbarkeit für mehrere Schlüssel

Standardmäßig werden nur Klassifizierungen zurückgegeben, die mit dem für den Aufruf verwendeten API-Schlüssel vorgenommen wurden. Aktivieren Sie all_keys=true, um Klassifizierungen aller Schlüssel in Ihrer Organisation zu sehen:

curl "https://api.thetradehub.eu/v1/classify/history?all_keys=true" \
  -H "X-API-Key: th_live_your_api_key"

Klassifizierungsverlauf auflisten

GET/v1/classify/history

Abfrageparameter

Parameter	Typ	Standard	Beschreibung
`page`	`number`	`1`	Seitenzahl
`per_page`	`number`	`20`	Ergebnisse pro Seite (max. 50)
`from`	`string` (ISO 8601)	-	Startdatum (einschließlich)
`to`	`string` (ISO 8601)	-	Enddatum (einschließlich)
`hs`	`string`	-	Filter nach HS-Code (Präfix akzeptiert, z.B. `8518`)
`status`	`string`	-	Filter nach Status: `completed`, `failed`
`source`	`string`	-	Filter nach Quelle: `api`, `web`, `batch`
`all_keys`	`boolean`	`false`	Einschluss von Klassifizierungen aller API-Schlüssel in der Organisation

Beispielanfrage

curl "https://api.thetradehub.eu/v1/classify/history?page=1&per_page=10&status=completed&from=2026-02-01T00:00:00Z" \
  -H "X-API-Key: th_live_your_api_key"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_your_api_key"},
)

response = client.get("/v1/classify/history", params={
    "page": 1,
    "per_page": 10,
    "status": "completed",
    "from": "2026-02-01T00:00:00Z",
})

data = response.json()
print(f"Total: {data['total']} Klassifizierungen")
for item in data["items"]:
    hs = item["result"]["classification"]["rankings"][0]["hs_code"]
    print(f"  {item['id']} - {hs} - {item['created_at']}")

const params = new URLSearchParams({
  page: "1",
  per_page: "10",
  status: "completed",
  from: "2026-02-01T00:00:00Z",
});

const response = await fetch(
  `https://api.thetradehub.eu/v1/classify/history?${params}`,
  { headers: { "X-API-Key": "th_live_your_api_key" } }
);

const data = await response.json();
console.log(`Total: ${data.total} Klassifizierungen`);
for (const item of data.items) {
  const hs = item.result.classification.rankings[0].hs_code;
  console.log(`  ${item.id} - ${hs} - ${item.created_at}`);
}

Antwort

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "completed",
      "content": "Kabellose Bluetooth-Kopfhörer",
      "result": {
        "classification": {
          "rankings": [
            {
              "rank": 1,
              "hs_code": "8518.30.00",
              "description": "Kopfhörer und Ohrhörer",
              "confidence": 0.94
            }
          ]
        }
      },
      "source": "api",
      "api_key_name": "Production Key",
      "created_at": "2026-02-24T10:30:00Z"
    }
  ],
  "total": 156,
  "page": 1,
  "per_page": 10,
  "pages": 16
}

Struktur der paginierten Antwort

Feld	Typ	Beschreibung
`items`	`object[]`	Liste der Klassifizierungen
`total`	`number`	Gesamtanzahl der Ergebnisse
`page`	`number`	Aktuelle Seite
`per_page`	`number`	Ergebnisse pro Seite
`pages`	`number`	Gesamtanzahl der Seiten

Details einer Klassifizierung abrufen

GET/v1/classify/history/{log_id}

Pfadparameter

Parameter	Typ	Beschreibung
`log_id`	`string` (UUID)	Klassifizierungskennung

Beispielanfrage

curl https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: th_live_your_api_key"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_your_api_key"},
)

response = client.get("/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890")
log = response.json()

print(f"Produkt: {log['content']}")
print(f"HS-Code: {log['result']['classification']['rankings'][0]['hs_code']}")
print(f"Vertrauenswürdigkeit: {log['result']['classification']['rankings'][0]['confidence']}")

const response = await fetch(
  "https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  { headers: { "X-API-Key": "th_live_your_api_key" } }
);

const log = await response.json();
console.log(`Produkt: ${log.content}`);
console.log(`HS-Code: ${log.result.classification.rankings[0].hs_code}`);
console.log(`Vertrauenswürdigkeit: ${log.result.classification.rankings[0].confidence}`);

Antwort

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "content": "Kabellose Bluetooth-Kopfhörer mit aktiver Geräuschunterdrückung",
  "image_urls": ["https://example.com/product/headphones.jpg"],
  "locale": "en",
  "result": {
    "classification": {
      "rankings": [
        {
          "rank": 1,
          "hs_code": "8518.30.00",
          "description": "Kopfhörer und Ohrhörer",
          "confidence": 0.94,
          "gri_justification": "GIR 1 - Das Produkt ist speziell durch die Position 8518 abgedeckt...",
          "validated": true
        }
      ]
    },
    "text": "Basierend auf EU vZTA-Beschlüssen und TARIC-Nomenklatur..."
  },
  "source": "api",
  "api_key_name": "Production Key",
  "session_id": "sess_abc123",
  "created_at": "2026-02-24T10:30:00Z",
  "updated_at": "2026-02-24T10:30:05Z"
}

Erweiterte Filter

Filter nach HS-Code

Der Parameter hs akzeptiert ein HS-Code-Präfix. Er filtert Klassifizierungen, deren bestes Ergebnis mit diesem Präfix beginnt:

# Alle Produkte, die unter Kapitel 85 (elektrische Maschinen und Geräte) klassifiziert sind
curl "https://api.thetradehub.eu/v1/classify/history?hs=85" \
  -H "X-API-Key: th_live_your_api_key"

# Spezifische Position 8518 (Mikrofone, Lautsprecher, Kopfhörer)
curl "https://api.thetradehub.eu/v1/classify/history?hs=8518" \
  -H "X-API-Key: th_live_your_api_key"

Filter nach Datumsbereich

Kombinieren Sie from und to, um den Zeitraum einzuschränken. Die Daten müssen im ISO 8601-Format sein:

# Klassifizierungen aus Februar 2026
curl "https://api.thetradehub.eu/v1/classify/history?from=2026-02-01T00:00:00Z&to=2026-02-28T23:59:59Z" \
  -H "X-API-Key: th_live_your_api_key"

Sichtbarkeit für mehrere Schlüssel

curl "https://api.thetradehub.eu/v1/classify/history?all_keys=true" \
  -H "X-API-Key: th_live_your_api_key"

Klassifizierungsverlauf auflisten

Abfrageparameter

Beispielanfrage

Antwort

Struktur der paginierten Antwort

Details einer Klassifizierung abrufen

Pfadparameter

Beispielanfrage

Antwort

Erweiterte Filter

Filter nach HS-Code

Filter nach Datumsbereich

Sichtbarkeit für mehrere Schlüssel

On this page

Verlauf

Klassifizierungsverlauf auflisten

Abfrageparameter

Beispielanfrage

Antwort

Struktur der paginierten Antwort

Details einer Klassifizierung abrufen

Pfadparameter

Beispielanfrage

Antwort

Erweiterte Filter

Filter nach HS-Code

Filter nach Datumsbereich

Sichtbarkeit für mehrere Schlüssel

On this page