Tài liệu API

Giao diện JSON cực kỳ sạch sẽ dựa trên API Key, loại bỏ tất cả HTML tiếp thị và trả lại dữ liệu có cấu trúc mà Đại lý có thể tiêu thụ trực tiếp.

Trung tâm phát triển Tài liệu MCP Tài liệu CLI Tài liệu kỹ năng Tài liệu API Yêu cầu API Key

Cách lấy API Key

Đăng ký tài khoản → Đăng nhập → Tự tạo API Key, toàn bộ quá trình không cần xem xét thủ công và có sẵn ngay lập tức.

1. Nhấp vào "Đăng ký" ở góc trên bên phải của trang web để đăng ký tài khoản (yêu cầu email của công ty).
2. Đăng nhập bằng email và mật khẩu "Sign in".
3. Vào trang "Yêu cầu API Key"，Nhấp vào nút "Tạo API Key".
4. Sao chép khóa đã tạo (bản rõ chỉ được hiển thị một lần, nếu bị mất thì phải tạo lại).
5. Mang Authorization: Bearer < key > trong tiêu đề yêu cầu để gọi tất cả các giao diện / api / v1 / dev / *.

api-key-flow

bash

# 1. Đăng ký tài khoản
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. Đăng nhập để nhận JWT
curl -X POST "https://api.tikchip.cn/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"you@company.com","password":"YourPass123"}'
# → Trả về data.token (JWT, cho các giao diện quản lý tiếp theo)

# 3. Tạo API Key với JWT
curl -X POST "https://api.tikchip.cn/api/v1/dev/keys" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production"}'
# → Trả về data.api _ key (tk _ xxx, chỉ hiển thị một lần, xin vui lòng lưu ngay lập tức)

# 4. Gọi giao diện nghiệp vụ với API Key
curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32"

Yêu cầu API Key ngay

Xác thực

Mang Authorization: Bearer < key > trong tiêu đề yêu cầu hoặc sử dụng 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"

Giới hạn hiện tại và hạn ngạch

Giao diện lớp tìm kiếm 60 lần / phút; submit _ inquiry mặc định 20 lần / ngày trên mỗi Key. Vượt quá giới hạn trả về 429 và Retry-After.

429

http

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

Danh sách điểm cuối

Tất cả các điểm cuối nằm trong tiền tố / api / v1 / dev và yêu cầu xác thực Khóa API Đại lý.

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

Khám phá điểm cuối (không cần Key)

Đại lý có thể tự động đọc khả năng xác định trang web của các điểm cuối công khai sau đây.

discovery

http

GET /api/v1/dev/agent-card.json   # Robot phiên bản Agent (danh tính / khả năng / tần số)
GET /api/v1/dev/manifest          # Danh sách các công cụ có thể đọc được bằng máy
GET /api/v1/dev/openapi           # Tài liệu OpenAPI 3.0

/api/v1/dev/agent-card.jsonAgent Card
/api/v1/dev/manifestDanh sách công cụ Manifest
/api/v1/dev/openapiTài liệu OpenAPI

Yêu cầu API Key