API ドキュメント

API Key ベースのクリーンな JSON インターフェース。マーケティング HTML を排除し、Agent が直接利用できる構造化データを返します。

開発者センター MCP ドキュメント CLI ドキュメント Skills ドキュメント API ドキュメント API Key を申請

APIキーの取得方法

アカウント登録→ログイン→APIキーのセルフ作成、全体のプロセスを手動で確認する必要はなく、すぐに利用できます。

1. ウェブサイトの右上隅にある「サインアップ」をクリックしてアカウントを登録します（企業のメールアドレスが必要です）。
2. メールアドレスとパスワード「Sign in」でログインします。
3. 「APIキーの申請」ページへ，「APIキーを作成」ボタンをクリックします。
4. 生成されたキーをコピーします（平文は1回だけ表示され、失われた場合は再作成する必要があります）。
5. リクエストヘッダーにAuthorization: Berer<key>を含めると、すべての/api/v 1/dev/*インターフェースを呼び出すことができます。

api-key-flow

bash

# 1. アカウントを登録する
curl -X POST "https://api.tikchip.cn/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com","password":"YourPass123","password_confirm":"YourPass123","company":"Your Company","username":"yourname"}'

# 2. ログインしてJWTを取得する
curl -X POST "https://api.tikchip.cn/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"you@company.com","password":"YourPass123"}'
# → data. token(JWT、後続の管理インタフェース用)を返します

# 3. JWTでAPIキーを作成する
curl -X POST "https://api.tikchip.cn/api/v1/dev/keys" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production"}'
# → data. api_keyを返します(tk_xxx、一度だけ表示されます。すぐに保存してください)

# 4. APIキーを使用してビジネスインターフェイスを呼び出す
curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32"

APIキーを今すぐ申請する

認証

リクエストヘッダーに Authorization: Bearer <key> を含めるか、X-TikChip-Key を使用します。

curl

bash

curl -H "Authorization: Bearer $TIKCHIP_API_KEY" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32F103C8T6&in_stock_only=true"

レート制限とクォータ

検索系インターフェースは毎分 60 回、submit_inquiry はデフォルトで 1 Key あたり 1 日 20 回です。超過時は 429 と Retry-After を返します。

429

http

HTTP/1.1 429 Too Many Requests
Retry-After: 12

エンドポイント一覧

すべてのエンドポイントは /api/v1/dev プレフィックス配下にあり、Agent API Key の認証が必要です。

Tool	Method	Endpoint
search_components	GET	/api/v1/dev/search
get_component_detail	GET	/api/v1/dev/component/{mpn}
compare_components	POST	/api/v1/dev/compare
check_stock	GET	/api/v1/dev/stock
recommend_alternatives	GET	/api/v1/dev/alternatives
submit_inquiry	POST	/api/v1/dev/inquiry
register_b2b_account	POST	/api/v1/dev/register
get_inquiry_messages	GET	/api/v1/dev/inquiry/{id}/messages
reply_to_inquiry	POST	/api/v1/dev/inquiry/{id}/reply
list_inquiries	GET	/api/v1/dev/inquiries
get_bom_price	POST	/api/v1/dev/bom/price

ディスカバリーエンドポイント（Key 不要）

Agent は以下の公開エンドポイントを自動的に読み取り、本サイトの機能を把握できます。

discovery

http

GET /api/v1/dev/agent-card.json   # エージェント版ロボット（アイデンティティ/能力/頻度）
GET /api/v1/dev/manifest          # 機械可読ツール一覧
GET /api/v1/dev/openapi           # Open API 3.0ドキュメント

/api/v1/dev/agent-card.jsonAgent Card
/api/v1/dev/manifestツール Manifest
/api/v1/dev/openapiOpenAPI ドキュメント

API Key を申請