Tianqixin Technology

API-Dokumentation

Eine extrem saubere JSON-Schnittstelle, die auf API Key basiert, entfernt jegliches Marketing-HTML und gibt strukturierte Daten zurück, die der Agent direkt nutzen kann.

So erhalten Sie einen API-Schlüssel

Ein Konto registrieren → sich anmelden → selbst einen API-Schlüssel erstellen, der gesamte Prozess erfordert keine manuelle Überprüfung und ist sofort verfügbar.

  1. 1. Klicken Sie auf "Sign up" in der oberen rechten Ecke der Website, um ein Konto zu registrieren (Firmen-E-Mail ist erforderlich).
  2. 2. Melden Sie sich mit E-Mail und Passwort an.
  3. 3. Gehen Sie zur Seite "API-Schlüssel anfordern",Klicken Sie auf die Schaltfläche "API-Schlüssel erstellen".
  4. 4. Kopieren Sie den generierten Schlüssel (Klartext wird nur einmal angezeigt, verloren muss neu erstellt werden).
  5. 5. Alle / api / v1 / dev / * Schnittstellen werden aufgerufen, indem Authorization: Bearer <key> im Request Header übertragen wird.
api-key-flow
bash
# 1. ein Konto registrieren
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. Melden Sie sich an, um JWT zu erhalten
curl -X POST "https://api.tikchip.cn/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"you@company.com","password":"YourPass123"}'
# → Rückgabe von data.token (JWT, verwendet für nachfolgende Verwaltungsschnittstellen)

# 3. API-Schlüssel mit JWT erstellen
curl -X POST "https://api.tikchip.cn/api/v1/dev/keys" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production"}'
# → Rückgabe data.api _ key (tk _ xxx, nur einmal angezeigt, jetzt speichern)

# 4. Aufruf der Geschäftsschnittstelle mit API-Schlüssel
curl -H "Authorization: Bearer <API_KEY>" \
  "https://api.tikchip.cn/api/v1/dev/search?keyword=STM32"

Authentifizierung

Carry Authorization: Bearer <key> im Request Header oder verwenden Sie 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"

Begrenzte Einschaltquoten

Suche Klassenschnittstelle 60 mal / Minute; sub _ quiry Standard 20 mal pro Schlüssel pro Tag. Über das Limit gibt 429 und Retry-After zurück.

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

Endpunkt-Liste

Alle Endpunkte befinden sich unter dem Präfix / api / v1 / dev und erfordern eine Agent-API-Schlüssel-Authentifizierung.

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

Endpunkte entdecken (kein Schlüssel erforderlich)

Der Agent kann automatisch die folgenden Funktionen zur Erkennung öffentlicher Endpunkte lesen.

discovery
http
GET /api/v1/dev/agent-card.json   # Agentenroboter (Identität / Fähigkeit / Frequenz)
GET /api/v1/dev/manifest          # Liste der maschinenlesbaren Werkzeuge
GET /api/v1/dev/openapi           # OpenAPI 3,0 Dokumentation
API-Dokumentation - Tianqixin Developer Center