Документация по API

Чрезвычайно чистый интерфейс JSON, основанный на API Key, удаляет весь маркетинговый HTML и возвращает структурированные данные, которые агент может использовать напрямую.

Центр разработчиков MCP документ Документация CLI Документация навыков Документация по API Подать заявку на API ключ

Как получить ключ API

Зарегистрируйте учетную запись → войдите в систему → создайте API Ключ самостоятельно, весь процесс не требует ручной проверки и доступен сразу.

1. Нажмите "Зарегистрироваться" в правом верхнем углу веб-сайта для регистрации учетной записи (требуется корпоративная почта).
2. Войдите с помощью электронной почты и пароля.
3. Перейдите на страницу "Запросить ключ API"，Нажмите кнопку "Create API Key".
4. Скопируйте сгенерированный Ключ (открытый текст отображается только один раз, потерянный необходимо воссоздать).
5. Все интерфейсы / api / v1 / dev / * вызываются с помощью указания Authorization: Bearer < 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"}'
# → Return data.token (JWT, используемый для последующих интерфейсов управления)

# 3. Создание API ключа с помощью JWT
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 ключ сейчас

аутентификация

Авторизация при переносе: Носитель < 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 по умолчанию 20 раз на ключ в день. Превышение лимита возвращает 429 и Retry-After.

429

http

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

список конечных точек

Все конечные точки находятся под префиксом / api / v1 / dev и требуют аутентификации ключа API агента.

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

Обнаружение конечных точек (ключ не требуется)

Агент может автоматически считывать следующие общедоступные возможности распознавания конечных точек.

discovery

http

GET /api/v1/dev/agent-card.json   # Роботы-агенты (идентификация / возможности / частота)
GET /api/v1/dev/manifest          # Список машиночитаемых инструментов
GET /api/v1/dev/openapi           # Документация OpenAPI 3,0

/api/v1/dev/agent-card.jsonAgent Card
/api/v1/dev/manifestМанифест инструмента
/api/v1/dev/openapiДокументация OpenAPI

Подать заявку на API ключ