Documentation API

Une interface JSON extrêmement propre basée sur la clé API supprime tout le HTML marketing et renvoie des données structurées que l'agent peut directement consommer.

Centre des développeurs Document MCP Documentation CLI Documentation sur les compétences Documentation API Demande de clé API

Comment obtenir une clé API

Enregistrez un compte → connectez-vous → créez une clé API par vous-même, l'ensemble du processus ne nécessite pas de révision manuelle et est disponible immédiatement.

1. Cliquez sur "Inscription" dans le coin supérieur droit du site Web pour enregistrer un compte (un e-mail d'entreprise est requis).
2. Connectez-vous avec un e-mail et un mot de passe.
3. Accédez à la page "Demander la clé API"，Cliquez sur le bouton "Créer une clé API".
4. Copiez la clé générée (le texte en clair n'est affiché qu'une seule fois, la clé perdue doit être recréée).
5. Toutes les interfaces / api / v1 / dev / * sont appelées en portant Authorization : Bearer <key> dans l'en-tête de la requête.

api-key-flow

bash

# 1. Enregistrer un compte
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. Connectez-vous pour obtenir 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, utilisé pour les interfaces de gestion ultérieures)

# 3. Créer une clé API avec JWT
curl -X POST "https://api.tikchip.cn/api/v1/dev/keys" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production"}'
# → Retournez data.api _ key (tk _ xxx, affiché une seule fois, enregistrez maintenant)

# 4. Appeler l'interface métier avec la clé API
curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32"

Demander une clé API maintenant

Authentification

Autorisation de portage : Porter <key> dans l'en-tête de la demande, ou utiliser 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"

Audience limitée des quotas

Interface de classe de recherche 60 fois / minute ; send _ enquired par défaut 20 fois par clé et par jour. Au-delà de la limite renvoie 429 et Retry-After.

429

http

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

Liste des points de terminaison

Tous les points de terminaison sont sous le préfixe / api / v1 / dev et nécessitent une authentification par clé API Agent.

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

Découvrir les points de terminaison (aucune clé requise)

L'agent peut lire automatiquement les capacités de reconnaissance des points de terminaison publics suivantes.

discovery

http

GET /api/v1/dev/agent-card.json   # Robots agents (identité / capacité / fréquence)
GET /api/v1/dev/manifest          # Liste des outils lisibles par machine
GET /api/v1/dev/openapi           # Documentation OpenAPI 3,0

/api/v1/dev/agent-card.jsonAgent Card
/api/v1/dev/manifestManifeste des outils
/api/v1/dev/openapiDocumentation OpenAPI

Demande de clé API