Tianqixin Technology

Documentación API

Una interfaz JSON extremadamente limpia basada en API Key elimina todo el HTML de marketing y devuelve datos estructurados que el agente puede consumir directamente.

Cómo obtener una clave de API

Registre una cuenta → inicie sesión → cree una Clave de API usted mismo, todo el proceso no requiere revisión manual y está disponible de inmediato.

  1. 1. Haga clic en "Registrarse" en la esquina superior derecha del sitio web para registrar una cuenta (se requiere correo electrónico corporativo).
  2. 2. Iniciar sesión con correo electrónico y contraseña.
  3. 3. Vaya a la página "Solicitar clave de API",Haga clic en el botón "Crear clave de API".
  4. 4. Copie la clave generada (el texto plano se muestra solo una vez, las pérdidas deben volver a crearse).
  5. 5. Todas las interfaces / api / v1 / dev / * se invocan llevando Autorización: Portador <key> en el encabezado de la solicitud.
api-key-flow
bash
# 1. Registrar una cuenta
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. Inicia sesión para obtener JWT
curl -X POST "https://api.tikchip.cn/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"you@company.com","password":"YourPass123"}'
# → Devuelve data.token (JWT, utilizado para posteriores interfaces de gestión)

# 3. Crear clave de API con JWT
curl -X POST "https://api.tikchip.cn/api/v1/dev/keys" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production"}'
# → Devuelve data.api _ key (tk _ xxx, solo se muestra una vez, guárdalo ahora)

# 4. Clave de API de con interfaz comercial de llamadas
curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32"

Autenticación

Autorización de transporte: Portador <key> en el encabezado de la solicitud, o 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"

Audiencia limitada de las cuotas

Interfaz de clase de búsqueda 60 veces / minuto; por defecto 20 veces por tecla por día. Por encima del límite devuelve 429 y Retry-After.

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

Lista de puntos finales

Todos los puntos finales están bajo el prefijo / api / v1 / dev y requieren autenticación de clave de API de 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

Descubre puntos finales (no se requiere clave)

El agente puede leer automáticamente las siguientes capacidades públicas de reconocimiento de endpoint.

discovery
http
GET /api/v1/dev/agent-card.json   # Robots de agentes (identidad / capacidad / frecuencia)
GET /api/v1/dev/manifest          # Lista de herramientas legibles por máquina
GET /api/v1/dev/openapi           # Documentación de OpenAPI 3,0
Documentación de API - Centro de Desarrolladores de Tianqixin