API 문서

API Key 기반의 깔끔한 JSON 인터페이스. 마케팅 HTML을 제거하고 Agent가 바로 사용할 수 있는 구조화된 데이터를 반환합니다.

개발자 센터 MCP 문서 CLI 문서 Skills 문서 API 문서 API Key 신청

API 키를 얻는 방법

계정 등록 → 로그인 → API 키를 직접 생성하십시오. 전체 프로세스는 수동 검토가 필요하지 않으며 즉시 사용할 수 있습니다.

1. 계정을 등록하려면 웹 사이트의 오른쪽 상단 모서리에 있는 "가입"을 클릭하십시오(회사 이메일이 필요함).
2. 이메일과 비밀번호로 로그인하세요.
3. "API 키 요청" 페이지로 이동，"API 키 만들기" 버튼을 클릭합니다.
4. 생성된 키를 복사합니다(일반 텍스트는 한 번만 표시되며 손실된 키를 다시 만들어야 함).
5. 모든 /api/v1/dev/* 인터페이스는 요청 헤더에 인증: 베어러 <key>를 전달하여 호출됩니다.

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"}'
# → 데이터 반환.토큰(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"}'
# → 데이터.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는 기본적으로 Key당 하루 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   # 에이전트 로봇(ID/기능/주파수)
GET /api/v1/dev/manifest          # 기계 읽기 도구 목록
GET /api/v1/dev/openapi           # OpenAPI 3.0 설명서

/api/v1/dev/agent-card.jsonAgent Card
/api/v1/dev/manifest도구 목록 Manifest
/api/v1/dev/openapiOpenAPI 문서

API Key 신청