API Dokumentation

Integration für Entwickler & AI-Agenten

API Key erstellen

🔐 Authentifizierung

Öffentlicher Zugriff

Für einfache Anwendungsfälle ohne Account.

  • Kein API Key notwendig
  • Rate Limit: 60 Requests / Minute (IP-basiert)
  • Keine Analytics oder Verwaltung

Mit API Key

Für professionelle Integrationen.

Authorization: Bearer sk_live_...
  • Höhere Rate Limits (1000+ Req/Min)
  • Links sind dem Account zugeordnet
  • Zugriff auf Analytics & Management API

🤖 AI Integration (MCP)

Verbinden Sie Claude, Cursor oder andere AI-Agenten direkt via Model Context Protocol.
*Erfordert API Key

SSE Endpoint: https://zhort.de/api/mcp

Endpoints

POST

/api/v1/shorten

Erstellt einen neuen gekürzten Link.

Request Body

{
  "url": "https://example.com",
  "customCode": "my-link", // optional
  "password": "secret",    // optional
  "expiresIn": "24h"       // optional
}

Response (201)

{
  "shortCode": "my-link",
  "shortUrl": "https://zhort.de/s/my-link",
  "originalUrl": "https://example.com"
}
GET

/api/analytics/{linkId}

Auth Required

Ruft detaillierte Statistiken für einen Link ab.

Sicherheit & Abuse Prevention

Alle URLs werden automatisch gegen globale Threat-Intelligence-Listen (Google Safe Browsing & Hagezi) geprüft. Wir blockieren Malware, Phishing und Spam proaktiv.