imup.cc v1 REST API & Native MCP

Entwickler-REST-API & Limits

Integrieren Sie Kurzlinks, Unshortening-Sicherheitsanalyse, Live-Umfragen, reaktive Formulare und QR-Generierung direkt in Ihre Apps und KI-Agenten.

Sliding-Window Ratenlimit Bearer / X-API-Key JSON-RPC 2.0 MCP SSRF-Geschützt

Ratenbegrenzung & Quotenrichtlinie

Um eine hohe Verfügbarkeit und faire Nutzung zu gewährleisten, werden alle REST- und MCP-Endpunkte durch eine millisekundengenaue Sliding-Window-Ratenbegrenzung geschützt.

60s Window
Mitgliedschaft & API-Schlüssel erforderlich Erforderlich

Für den Zugriff auf die REST-API-Endpunkte sind eine Mitgliedschaft und ein gültiger API-Schlüssel (Bearer oder X-API-Key) zwingend erforderlich. Nicht authentifizierte Anfragen werden mit HTTP 401 abgewiesen.

Ratenbegrenzung & Kontingente (Sliding Window) 120 - 300 req / min

Verifizierte API-Schlüssel und Mitgliedskonten erhalten ein Kontingent von 120 bis 300 Anfragen pro 1-minütigem Zeitfenster.

Standard HTTP-Ratenbegrenzungs-Header

Header Beschreibung Beispielwert
X-RateLimit-Limit Gesamtzahl der im aktuellen Fenster erlaubten Anfragen 120
X-RateLimit-Remaining Verbleibendes Kontingent bis zum Reset 119
X-RateLimit-Reset Unix-Zeitstempel für den Reset des Fensters (Sekunden) 1760618400
Retry-After Wartezeit in Sekunden bei HTTP 429 vor dem nächsten Versuch 42
REST-API HTTP 401 (Schlüssel erforderlich) Antwort
{
  "success": false,
  "error": "API key or membership is required to access the REST API. Please sign in or pass an API key.",
  "code": "API_KEY_REQUIRED"
}
REST API HTTP 429 Antwort
{
  "success": false,
  "error": "Rate limit exceeded. Try again in 42 seconds.",
  "retryAfter": 42,
  "limit": 120
}
MCP (JSON-RPC 2.0) HTTP 429 Antwort
{
  "jsonrpc": "2.0",
  "id": "req-1",
  "error": {
    "code": -32000,
    "message": "Rate limit exceeded. Try again in 42 seconds."
  }
}

Authentifizierung

Für den Zugriff auf alle REST-API-Endpunkte sind eine Mitgliedschaft und ein gültiger API-Schlüssel erforderlich. Sie können Ihren API-Schlüssel in HTTP-Anfragen in einem der folgenden Formate übergeben:

Format 1: Bearer Token
Authorization: Bearer imup_live_xxxxxxxxxxxxxxxx
Format 2: X-API-Key Header
X-API-Key: imup_live_xxxxxxxxxxxxxxxx
Sie können Ihren API-Schlüssel direkt im Verwaltungs-Dashboard oder über die MCP Hub -Integration erstellen.

REST API v1 Endpunkte

Alle Endpunkte akzeptieren und liefern JSON-Daten.

15 Aktive Endpunkte
GET /api/v1
Cost: 1 120 - 300/min (Key/Member)

API Discovery & Rate Limit Status

Returns API version, client IP / authentication state, and current sliding window rate limit quotas.

Beispiel-cURL-Aufruf
curl -X GET "https://imup.cc/api/v1" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/links
Cost: 1 120 - 300/min (Key/Member)

Create Short Link

Shortens a long target URL with optional custom slug, password, title, and expiration.

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/v1/links" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://example.com/very-long-url", "title": "My Link"}'
GET /api/v1/links/:id
Cost: 1 120 - 300/min (Key/Member)

Get Link Details & Stats

Retrieves link details, destination URL, active status, creation date, and total click counter.

Beispiel-cURL-Aufruf
curl -X GET "https://imup.cc/api/v1/links/LINK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
PATCH /api/v1/links/:id
Cost: 1 120 - 300/min (Key/Member)

Update Short Link

Updates destination target URL, status (active/inactive), and title.

Beispiel-cURL-Aufruf
curl -X PATCH "https://imup.cc/api/v1/links/LINK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://example.com/updated-url"}'
DELETE /api/v1/links/:id
Cost: 1 120 - 300/min (Key/Member)

Delete Short Link

Permanently removes a short link from the registry.

Beispiel-cURL-Aufruf
curl -X DELETE "https://imup.cc/api/v1/links/LINK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/links/unshorten
Cost: 1 120 - 300/min (Key/Member)

Unshorten & Security Analysis

Resolves redirect chains for any shortened URL, validates safety, and strips UTM/tracking params.

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/v1/links/unshorten" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://bit.ly/3xyz?utm_source=test"}'
POST /api/v1/links/bulk
Cost: N (1 per URL) 120 - 300/min (Key/Member)

Bulk Shorten Links

Creates up to 50 short links in a single atomic transaction. Rate limit cost equals number of URLs.

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/v1/links/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://site1.com", "https://site2.com"]}'
POST /api/v1/polls
Cost: 1 120 - 300/min (Key/Member)

Create Live Poll

Creates a real-time polling widget with custom question and up to 10 choices.

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/v1/polls" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Favorite stack?", "options": ["Node.js", "Next.js", "Django"]}'
GET /api/v1/polls/:uuid
Cost: 1 120 - 300/min (Key/Member)

Get Poll & Live Results

Retrieves poll questions, option vote counts, and calculated percentage distribution.

Beispiel-cURL-Aufruf
curl -X GET "https://imup.cc/api/v1/polls/POLL_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/polls/:uuid/vote
Cost: 1 120 - 300/min (Key/Member)

Cast Poll Vote

Submits a vote for a specific option ID with anti-ballot stuffing validation.

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/v1/polls/POLL_UUID/vote" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"option_ids": [1]}'
POST /api/v1/forms
Cost: 1 120 - 300/min (Key/Member)

Create Reactive Form

Creates a custom form with flexible fields (text, email, select, rating, textarea).

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/v1/forms" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Customer Feedback", "description": "Quick survey"}'
GET /api/v1/forms/:uuid
Cost: 1 120 - 300/min (Key/Member)

Get Form Schema & Stats

Fetches form fields, configuration, status, and response counts.

Beispiel-cURL-Aufruf
curl -X GET "https://imup.cc/api/v1/forms/FORM_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/forms/:uuid/submit
Cost: 1 120 - 300/min (Key/Member)

Submit Form Response

Submits validated answers for form fields with optional idempotency key.

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/v1/forms/FORM_UUID/submit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"answers": {"FIELD_ID_1": "Ahmet", "FIELD_ID_2": "user@example.com"}}'
GET /api/v1/qr
Cost: 1 120 - 300/min (Key/Member)

Generate QR Code

Generates high-resolution QR codes in PNG (binary), SVG (vector), or JSON (base64 data URL).

Beispiel-cURL-Aufruf
curl -X GET "https://imup.cc/api/v1/qr?text=https://imup.cc&format=png&size=300" \
  -H "Authorization: Bearer YOUR_API_KEY" --output qr.png
POST / GET /api/mcp
Cost: 1 60/min (IP), 300/min (Key)

Model Context Protocol (MCP) Endpoint

JSON-RPC 2.0 endpoint for AI assistants (Claude Desktop, Cursor, Windsurf) featuring 14 native tools. Governed by identical sliding window rate limits.

Beispiel-cURL-Aufruf
curl -X POST "https://imup.cc/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": "1", "method": "tools/list"}'
Model Context Protocol

MCP-Server für KI-Agenten

Verwalten Sie Kurzlinks, Umfragen und Formulare direkt aus Cursor, Claude Desktop oder Windsurf. Unterliegt denselben schnellen Sliding-Window-Ratenlimits.

MCP Hub ansehen