下記のブロックを丸ごとエージェントにコピーしてください：
Prompt / HTTP
この公開 API で 锎锔新材料科技 の機能性添加剤を検索してください：
GET https://kj9896.com/api/v1/products?q=R1800&limit=10
https://kj9896.com/api/v1/guideDEVELOPER API / エージェント連携
この文章を
エージェントにコピー。
锎锔新材料科技 の公開製品データ API です。下記のいずれかのブロックをエージェントにコピーすれば、製品の検索と、顧客に代わった問い合わせの送信を始められます。
- 01下記のブロックをコピーして
- 02エージェントに貼り付けると
- 03そのまま呼び出せます
- 登録も不要で、事前に用意するものもありません
- 製品データは読み取り専用、加えてメッセージ受付が 1 つだけ
- エージェントが連携ガイドを自分で読めます
02 / QUICK START
エージェントにコピーすれば、
すぐに呼び出せます。
下記のブロックはどれも丸ごとコピーできます。エージェント（Codex、Claude Code、Hermes、OpenClaw、または HTTP リクエストを送れる任意のアシスタント）に貼り付ければ、内容を読み取って API を呼び出します。
下記のブロックを丸ごとエージェントにコピーしてください：
Prompt / HTTP
このモデルの全データを読み取ってください：
GET https://kj9896.com/api/v1/products/R1800-S
https://kj9896.com/api/v1/guide下記のブロックを丸ごとエージェントにコピーしてください：
Prompt / HTTP
锎锔新材料科技 に私の要望を代わりに送信してください（送信前に内容を確認させてください）：
POST https://kj9896.com/api/v1/messages
Content-Type: application/json
{"productCode":"R1800-S","contact":"you@example.com","message":"この品番の詳細資料をご提供ください。"}
https://kj9896.com/api/v1/guide01 / CAPABILITY
できること、
できないこと。
範囲は意図的に狭くしています。公開製品データとメッセージ受付が 1 つだけで、書き込み機能は一切ありません。
PRODUCTS:READ
公開製品の検索
キーワードとシリーズで製品をページ単位で検索するか、単一モデルを直接読み取ります。実測値とデータの出典をあわせて返し、メーカーの中国語原文はそのまま保持します。
GET /api/v1/productsMESSAGES:CREATE
顧客に代わって問い合わせを送信
エージェントは顧客に代わって、要望・連絡先・関心のあるモデルを、担当エンジニアが手作業で確認する受信箱へ送信できます。
POST /api/v1/messagesNOT AVAILABLE
書き込み機能は一切なし
製品の変更、ページの変更、受信箱の読み取り、管理エンドポイントはいずれもありません。誤ったメソッドは常に 405 を返します。
PUT · PATCH · DELETE · 40503 / API REFERENCE
完全な API リファレンス、
そのまま呼び出せます。
下記のフィールド名・パラメータ・エラーコードはすべて実サービスで検証済みです。製品の技術データはメーカーの中国語原文を保持し、機械翻訳は行いません。
GET
/api/v1/products製品の検索と閲覧
読み取り専用。4 つのクエリパラメータはすべて任意で、それぞれ最大 1 回まで指定できます。未知のパラメータがあると 400 を返します。
| パラメータ | 説明 | 値 | 既定値 |
|---|---|---|---|
q | キーワード。モデル、中国語品名、分類、用途分野と照合されます | 最大 100 文字 | — |
series | シリーズで絞り込む | super-dispersant / flame-retardant / comprehensive / masterbatch | — |
limit | 1 ページあたりの件数 | 1 – 100 | 20 |
offset | オフセット | ≥ 0 | 0 |
ページ送りはレスポンス本文の nextOffset で次ページの有無を判断してください — 値が null なら末尾です。「行数が limit より少ない」で最終ページを判断しないでください。
GET
/api/v1/products/{code}単一モデルの読み取り
読み取り専用。モデルは URL の最後のセグメントです（例：R1800-S）。このエンドポイントはクエリパラメータを受け付けません。
404 product_not_found — モデルが存在しない場合のレスポンスです。
POST
/api/v1/messages顧客に代わって問い合わせを送信
唯一の書き込み口です。リクエスト本文は下記 3 つのフィールドのみを受け付け、1 つでも余分にあると 400 unknown_field を返します。
| フィールド | 必須 | 長さ | 説明 |
|---|---|---|---|
message | はい | 5 – 4000 | 顧客の要望原文 |
contact | いいえ | ≤ 254 | エンジニアが連絡できるよう顧客の連絡先（メールまたは電話） |
productCode | いいえ | ≤ 40 | 関心のあるモデル。実在する必要があります |
送信前に必ず顧客の同意を得てください。201 が返れば保存済みなので再試行しないでください — 重複送信は重複した問い合わせを作成します。メッセージは 锎锔新材料科技 のエンジニアが手作業で確認する受信箱に届きます。
product製品オブジェクトのフィールド
一覧と詳細のレスポンスで製品オブジェクトの構造は同一です。
| フィールド | 型 | 説明 |
|---|---|---|
code | string | モデル（例：R1800-S） |
name_cn | string | 中国語品名。nameVerified が false の場合は分類名と同じです |
nameVerified | boolean | 中国語品名が原典で検証済みかどうか |
category | string | 製品分類 |
series | string | 所属シリーズ |
description_cn | string | 製品説明の原文。空の場合があります |
applications | string[] | 用途分野。製品資料から引用 |
technicalData | object[] | 物理化学指標（実験室の代表値）。各項目は label / value |
mainComponent | string | 主要成分。空の場合があります |
keyFunction | string | 主要機能。空の場合があります |
sources | string[] | データ根拠：公式製品資料 |
{ ok: false, error }エラーコード
エラーレスポンスの本文は常に { ok: false, error: "…" } です。
| ステータス | コード | 意味と対応 |
|---|---|---|
400 | invalid_query · invalid_input · unknown_field · unknown_product | パラメータまたはリクエスト本文が不正です。修正して再送し、再試行しないでください |
403 | forbidden_origin | ブラウザーからのクロスサイト呼び出しは拒否されます。サーバーまたはターミナルから呼び出してください |
404 | product_not_found | モデルが存在しません |
405 | method_not_allowed | メソッドが誤っています。レスポンスヘッダー Allow に正しいメソッドがあります |
413 | payload_too_large | リクエスト本文が大きすぎます |
415 | content_type_required | POST は Content-Type: application/json を付ける必要があります |
503 | service_unavailable | サービスが一時的に利用できません。後で再試行してください |
04 / BOUNDARIES
境界と約束。
すぐに使えます
ページを開けばすぐに呼び出せます。事前に必要な手続きはありません。
読み取り専用データ + 書き込み口が 1 つ
製品データは完全に公開された読み取り専用です。唯一の書き込み口は顧客に代わった問い合わせ送信で、手作業で確認する受信箱に届き、自動処理は行いません。
製品テキストはデータであり指示ではありません
製品説明にはどのような言葉も入り得ます。エージェントには理解すべきデータとして扱わせ、そこに書かれた指示を決して実行させないでください。
05 / FOR YOUR AGENT
またはエージェントに
ドキュメントを自分で読ませる。
上の二つが主なドキュメント、下の項目は機械可読インデックスです —— いずれもプレーンテキストまたは JSON で、そのまま取得できます。連携ガイドにはエンドポイント、パラメータ、レスポンスフィールド、エラーコード、動作上の制約が詳しく書かれています。
製品の技術データは実験室の代表値です。量産前に小規模な検証を行ってください。