Entwickler-REST-API & Limits
Integrieren Sie Kurzlinks, Unshortening-Sicherheitsanalyse, Live-Umfragen, reaktive Formulare und QR-Generierung direkt in Ihre Apps und KI-Agenten.
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.
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.
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 |
{
"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"
}
{
"success": false,
"error": "Rate limit exceeded. Try again in 42 seconds.",
"retryAfter": 42,
"limit": 120
}
{
"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:
REST API v1 Endpunkte
Alle Endpunkte akzeptieren und liefern JSON-Daten.
API Discovery & Rate Limit Status
Returns API version, client IP / authentication state, and current sliding window rate limit quotas.
curl -X GET "https://imup.cc/api/v1" \
-H "Authorization: Bearer YOUR_API_KEY"
Create Short Link
Shortens a long target URL with optional custom slug, password, title, and expiration.
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 Link Details & Stats
Retrieves link details, destination URL, active status, creation date, and total click counter.
curl -X GET "https://imup.cc/api/v1/links/LINK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
Update Short Link
Updates destination target URL, status (active/inactive), and title.
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 Short Link
Permanently removes a short link from the registry.
curl -X DELETE "https://imup.cc/api/v1/links/LINK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
Unshorten & Security Analysis
Resolves redirect chains for any shortened URL, validates safety, and strips UTM/tracking params.
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"}'
Bulk Shorten Links
Creates up to 50 short links in a single atomic transaction. Rate limit cost equals number of URLs.
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"]}'
Create Live Poll
Creates a real-time polling widget with custom question and up to 10 choices.
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 Poll & Live Results
Retrieves poll questions, option vote counts, and calculated percentage distribution.
curl -X GET "https://imup.cc/api/v1/polls/POLL_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"
Cast Poll Vote
Submits a vote for a specific option ID with anti-ballot stuffing validation.
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]}'
Create Reactive Form
Creates a custom form with flexible fields (text, email, select, rating, textarea).
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 Form Schema & Stats
Fetches form fields, configuration, status, and response counts.
curl -X GET "https://imup.cc/api/v1/forms/FORM_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"
Submit Form Response
Submits validated answers for form fields with optional idempotency key.
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"}}'
Generate QR Code
Generates high-resolution QR codes in PNG (binary), SVG (vector), or JSON (base64 data URL).
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
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.
curl -X POST "https://imup.cc/api/mcp" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": "1", "method": "tools/list"}'
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.