40066-88888
Tianqixin Technology

Documentação API

Uma interface JSON extremamente limpa baseada em API Key remove todo o HTML de marketing e retorna dados estruturados que o agente pode consumir diretamente.

Como obter uma chave API

Registre uma conta → faça login → crie uma API Key sozinho, todo o processo não requer revisão manual e está disponível imediatamente.

  1. 1. Clique em "Inscrever-se" no canto superior direito do site para registrar uma conta (e-mail corporativo é necessário).
  2. 2. Faça login com e-mail e senha.
  3. 3. Ir para a página "Solicitar chave API",Clique no botão "Criar chave API."
  4. 4. Copie a chave gerada (texto simples é exibido apenas uma vez, perdido precisa ser recriado).
  5. 5. Todas as interfaces / api / v1 / dev / * são invocadas carregando Autorização: Portador <key> no cabeçalho da solicitação.
api-key-flow
bash
# 1. Registar uma conta
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. Faça login para obter o JWT
curl -X POST "https://api.tikchip.cn/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"you@company.com","password":"YourPass123"}'
# → Retornar data.token (JWT, usado para interfaces de gerenciamento subsequentes)

# 3. Criar chave API com JWT
curl -X POST "https://api.tikchip.cn/api/v1/dev/keys" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production"}'
# → Retorne data.api _ key (tk _ xxx, exibido apenas uma vez, salve agora)

# 4. Chamando a interface de negócios com chave de API
curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32"

Autenticação

Carregar autorização: portador <key> no cabeçalho da solicitação ou use 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"

Visualização limitada de cotas

Interface de classe de pesquisa 60 vezes / minuto; submeter _ inquérito padrão 20 vezes por chave por dia. Acima do limite retorna 429 e Retry-After.

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

Lista de pontos finais

Todos os endpoints estão sob o prefixo / api / v1 / dev e exigem autenticação de chave de API do agente.

ToolMethodEndpoint
search_componentsGET/api/v1/dev/search
get_component_detailGET/api/v1/dev/component/{mpn}
compare_componentsPOST/api/v1/dev/compare
check_stockGET/api/v1/dev/stock
recommend_alternativesGET/api/v1/dev/alternatives
submit_inquiryPOST/api/v1/dev/inquiry
register_b2b_accountPOST/api/v1/dev/register
get_inquiry_messagesGET/api/v1/dev/inquiry/{id}/messages
reply_to_inquiryPOST/api/v1/dev/inquiry/{id}/reply
list_inquiriesGET/api/v1/dev/inquiries
get_bom_pricePOST/api/v1/dev/bom/price

Descobrir pontos finais (nenhuma chave necessária)

O Agent pode ler automaticamente os seguintes recursos de reconhecimento de ponto final público.

discovery
http
GET /api/v1/dev/agent-card.json   # Robôs agentes (identidade / capacidade / frequência)
GET /api/v1/dev/manifest          # Lista de ferramentas legíveis por máquina
GET /api/v1/dev/openapi           # Documentação do OpenAPI 3.0
Documentação de API - Tianqixin Developer Center