Dokumentasi API

Antarmuka JSON yang sangat bersih berdasarkan API Key menghapus semua HTML pemasaran dan mengembalikan data terstruktur yang dapat langsung dikonsumsi agen.

Pusat Pengembang dokumen MCP Dokumentasi KLI Dokumentasi Keterampilan Dokumentasi API Terapkan untuk Kunci API

Cara mendapatkan Kunci API

Daftarkan akun → masuk → buat Kunci API sendiri, seluruh proses tidak memerlukan tinjauan manual dan segera tersedia.

1. Klik "Daftar" di sudut kanan atas situs web untuk mendaftarkan akun (email perusahaan diperlukan).
2. Masuk dengan email dan kata sandi.
3. Buka halaman "Minta API Key"，Klik tombol "Buat Kunci API."
4. Salin Kunci yang dihasilkan (plaintext ditampilkan hanya sekali, hilang perlu dibuat ulang).
5. All / api / v1 / dev / * interface dipanggil dengan membawa Otorisasi: Pembawa < key > di header permintaan.

api-key-flow

bash

# 1. Daftarkan akun
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. Masuk untuk mendapatkan 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 kembalia.token (JWT, digunakan untuk antarmuka manajemen berikutnya)

# 3. Buat Kunci API dengan JWT
curl -X POST "https://api.tikchip.cn/api/v1/dev/keys" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production"}'
# → Kembali data.api _ key (tk _ xxx, hanya ditampilkan sekali, simpan sekarang)

# 4. Memanggil Antarmuka Bisnis dengan Kunci API
curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32"

Terapkan untuk Kunci API Sekarang

otentikasi

Bawa Otorisasi: Pembawa < key > di header permintaan, atau gunakan 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"

Penayangan kuota terbatas

Antarmuka kelas pencarian 60 kali / menit; submit _ inquiry default 20 kali per tombol per hari. Melebihi batas pengembalian 429 dan Retry-After.

429

http

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

daftar titik akhir

Semua titik akhir berada di bawah awalan / api / v1 / dev dan memerlukan otentikasi 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

Temukan titik akhir (tidak diperlukan kunci)

Agen dapat secara otomatis membaca kemampuan pengenalan titik akhir publik berikut.

discovery

http

GET /api/v1/dev/agent-card.json   # Robot agen (identitas / kemampuan / frekuensi)
GET /api/v1/dev/manifest          # Daftar Alat yang Dapat Dibaca Mesin
GET /api/v1/dev/openapi           # Dokumentasi OpenAPI 3.0

/api/v1/dev/agent-card.jsonAgent Card
/api/v1/dev/manifestManifestasi Alat
/api/v1/dev/openapiDokumentasi OpenAPI

Terapkan untuk Kunci API