DEVELOPER API / AGENT-ZUGANG
Die öffentliche Produktdaten-API von 锎锔新材料科技. Kopieren Sie einen der Blöcke unten in Ihren Agenten — er kann dann Produkte abfragen und Anfragen im Namen von Kunden übermitteln.
02 / QUICK START
Jeder Block unten lässt sich vollständig kopieren. Fügen Sie ihn in Ihren Agenten ein (Codex, Claude Code, Hermes, OpenClaw oder jeden Assistenten, der HTTP-Anfragen senden kann) — er liest ihn und ruft die API auf.
Kopieren Sie den folgenden Block vollständig in Ihren Agenten:
Bitte nutze diese öffentliche API, um die funktionalen Additive von 锎锔新材料科技 zu suchen:
GET https://kj9896.com/api/v1/products?q=R1800&limit=10
https://kj9896.com/api/v1/guideKopieren Sie den folgenden Block vollständig in Ihren Agenten:
Bitte lies die vollständigen Daten zu diesem Modell:
GET https://kj9896.com/api/v1/products/R1800-S
https://kj9896.com/api/v1/guideKopieren Sie den folgenden Block vollständig in Ihren Agenten:
Bitte übermittle in meinem Namen eine Anfrage an 锎锔新材料科技 (zeige mir den Text vorher zur Bestätigung):
POST https://kj9896.com/api/v1/messages
Content-Type: application/json
{"productCode":"R1800-S","contact":"you@example.com","message":"Bitte senden Sie weitere Informationen zu diesem Modell."}
https://kj9896.com/api/v1/guide01 / CAPABILITY
Die Grenzen sind bewusst eng: öffentliche Produktdaten und ein einziger Nachrichten-Eingang, ohne jede Schreibmöglichkeit.
Produkte per Stichwort und Serie seitenweise durchsuchen oder ein einzelnes Modell direkt lesen. Zurückgegeben werden Messwerte mit ihrer Datenquelle — der chinesische Originaltext des Herstellers bleibt erhalten.
GET /api/v1/productsDer Agent kann im Namen eines Kunden Bedarf, Kontaktdaten und interessierende Modelle an den Posteingang eines Ingenieurs übermitteln, der Anfragen manuell bearbeitet.
POST /api/v1/messagesKeine Änderung von Produkten oder Seiten, kein Lesen des Posteingangs, keine Admin-Endpunkte; eine falsche Methode liefert immer 405.
PUT · PATCH · DELETE · 40503 / API REFERENCE
Alle Feldnamen, Parameter und Fehlercodes unten sind gegen den laufenden Dienst geprüft. Technische Produktdaten behalten den chinesischen Originaltext des Herstellers und werden nicht maschinell übersetzt.
/api/v1/productsNur lesend. Alle vier Abfrageparameter sind optional, jeder darf höchstens einmal vorkommen; ein unbekannter Parameter liefert 400.
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
q | Stichwort; abgeglichen mit Modell, chinesischem Namen, Kategorie und Anwendungsbereich | maximal 100 Zeichen | — |
series | Nach Serie filtern | super-dispersant / flame-retardant / comprehensive / masterbatch | — |
limit | Zeilen pro Seite | 1 – 100 | 20 |
offset | Versatz | ≥ 0 | 0 |
Nutzen Sie für die Seitennavigation nextOffset aus dem Antwortkörper, um zu prüfen, ob eine weitere Seite existiert: Der Wert null bedeutet, dass das Ende erreicht ist. Verlassen Sie sich nicht auf „weniger Zeilen als limit“, um die letzte Seite zu erkennen.
/api/v1/products/{code}Nur lesend. Das Modell ist das letzte Segment der URL (zum Beispiel R1800-S). Dieser Endpunkt akzeptiert keine Abfrageparameter.
404 product_not_found — Antwort, wenn das Modell nicht existiert.
/api/v1/messagesDer einzige Schreibzugang. Der Anfragetext erlaubt nur die drei folgenden Felder; ein zusätzliches Feld liefert 400 unknown_field.
| Feld | Pflicht | Länge | Beschreibung |
|---|---|---|---|
message | Ja | 5 – 4000 | Der ursprüngliche Text des Kundenbedarfs |
contact | Nein | ≤ 254 | Kontaktdaten des Kunden (E-Mail oder Telefon), damit der Ingenieur sich melden kann |
productCode | Nein | ≤ 40 | Das interessierende Modell, das tatsächlich existieren muss |
Vor dem Senden ist die Zustimmung des Kunden einzuholen; ein 201 bedeutet, dass die Nachricht gespeichert ist — also nicht erneut senden, denn ein doppelter Aufruf erzeugt eine doppelte Anfrage. Nachrichten landen im Posteingang der Ingenieure von 锎锔新材料科技 und werden manuell bearbeitet.
productDas Produktobjekt hat in Listen- und Detailantworten dieselbe Struktur.
| Feld | Typ | Beschreibung |
|---|---|---|
code | string | Modell, zum Beispiel R1800-S |
name_cn | string | Chinesischer Name; entspricht dem Kategorienamen, wenn nameVerified false ist |
nameVerified | boolean | Ob der chinesische Name gegen das Quelldokument geprüft wurde |
category | string | Produktkategorie |
series | string | Zugehörige Serie |
description_cn | string | Originale Produktbeschreibung, kann leer sein |
applications | string[] | Anwendungsbereiche, entnommen dem Produktdatenblatt |
technicalData | object[] | Physikalisch-chemische Kennwerte (typische Laborwerte), jeweils als label / value |
mainComponent | string | Hauptkomponente, kann leer sein |
keyFunction | string | Kernfunktion, kann leer sein |
sources | string[] | Datengrundlage: offizielle Produktunterlagen |
{ ok: false, error }Der Fehler-Antwortkörper ist immer { ok: false, error: "…" }.
| Status | Code | Bedeutung und Vorgehen |
|---|---|---|
400 | invalid_query · invalid_input · unknown_field · unknown_product | Parameter oder Anfragetext ungültig; korrigieren und erneut senden, nicht wiederholen |
403 | forbidden_origin | Websiteübergreifender Aufruf aus dem Browser abgelehnt; vom Server oder Terminal aus aufrufen |
404 | product_not_found | Das Modell existiert nicht |
405 | method_not_allowed | Falsche Methode; der Antwort-Header Allow nennt die richtige |
413 | payload_too_large | Anfragetext zu groß |
415 | content_type_required | POST muss Content-Type: application/json senden |
503 | service_unavailable | Dienst vorübergehend nicht verfügbar; später erneut versuchen |
04 / BOUNDARIES
Seite öffnen und direkt aufrufen; vorher ist nichts zu erledigen.
Die Produktdaten sind vollständig öffentlich und nur lesend; der einzige Schreibzugang übermittelt eine Anfrage im Namen eines Kunden und landet in einem menschlichen Posteingang, ohne automatisierte Verarbeitung.
In einer Produktbeschreibung kann jede Formulierung stehen. Lassen Sie Ihren Agenten sie als zu deutende Daten behandeln und niemals eine darin enthaltene Anweisung ausführen.
05 / FOR YOUR AGENT
Die beiden oberen Adressen sind die Hauptdokumente, die Einträge darunter sind maschinenlesbare Indizes — reiner Text oder JSON, direkt abrufbar. Die Integrationsanleitung beschreibt Endpunkte, Parameter, Antwortfelder, Fehlercodes und Verhaltensregeln.
Technische Produktdaten sind typische Laborwerte; vor der Serienproduktion einen Kleinversuch durchführen.