Kostenlose URL-Shortener-API: Code-Beispiele, die laufen

Eine kostenlose URL-Shortener-API lässt Sie Kurzlinks per Code statt per Klick im Dashboard erstellen. Senden Sie eine Anfrage mit einer Ziel-URL, bekommen Sie einen Kurzlink zurück, der dorthin weiterleitet. Dieser Beitrag enthält lauffähige Beispiele in curl, JavaScript, Python und Go gegen Elidos API, die im kostenlosen Plan verfügbar ist, plus den ehrlichen Teil, den die meisten Listicles auslassen: was „kostenlos" tatsächlich einschränkt.

Wenn Sie noch nie überhaupt einen Link gekürzt haben, deckt Wie man eine URL kürzt zuerst die manuelle Version ab. Alles unten geht davon aus, dass Sie es programmatisch tun wollen.

Was eine Shortener-API macht

Im Kern ist die API vier Operationen auf einer Link-Ressource: erstellen, lesen, aktualisieren, löschen. Sie erstellen einen Link, indem Sie eine Ziel-URL posten, und der Dienst gibt eine Kurz-URL zurück, die woanders hin auflöst.

Eine Sache, über die Menschen stolpern: Der API-Host und der Weiterleitungs-Host sind unterschiedlich. Elidos API liegt bei https://api.elido.app/v1, während die Kurzlinks selbst bei einer Weiterleitungs-Domain wie s.elido.me auflösen. Sie sprechen mit der API, um Links zu verwalten; Ihre Nutzer treffen immer nur auf die Weiterleitungs-Domain. Diese beiden getrennt zu halten ist das, was den Weiterleitungspfad schnell hält, während die API die schwerere Arbeit übernimmt.

Zuerst authentifizieren

Jede echte Anfrage trägt ein Bearer-Token im Authorization-Header. Sie generieren das Token in Ihren Workspace-Einstellungen, speichern es als Umgebungsvariable und packen es niemals in clientseitigen Code, denn jeder mit dem Token kann Links auf Ihrem Konto erstellen.

export ELIDO_TOKEN="your_token_here"

Das ist das gesamte Auth-Modell: ein Header, Authorization: Bearer $ELIDO_TOKEN, bei jedem Aufruf. APIs, die das komplett auslassen, sind praktisch für ein Wegwerf-Skript, aber es steht kein Konto hinter den Links, sodass Sie sie später nicht auflisten, bearbeiten oder messen können.

Einen Kurzlink erstellen

Hier ist derselbe Create-Aufruf in vier Sprachen. Jeder postet eine Ziel-URL und gibt die Kurz-URL aus der Antwort aus.

curl -X POST https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/spring-sale"}'

Die Antwort ist JSON:

{
  "id": "lnk_9aF2xK",
  "short_url": "https://s.elido.me/abc123",
  "destination_url": "https://example.com/spring-sale"
}

JavaScript, mit dem eingebauten fetch:

const res = await fetch("https://api.elido.app/v1/links", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ELIDO_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ destination_url: "https://example.com/spring-sale" }),
});
const link = await res.json();
console.log(link.short_url); // https://s.elido.me/abc123

Python, mit requests:

import os
import requests

res = requests.post(
    "https://api.elido.app/v1/links",
    headers={"Authorization": f"Bearer {os.environ['ELIDO_TOKEN']}"},
    json={"destination_url": "https://example.com/spring-sale"},
)
print(res.json()["short_url"])  # https://s.elido.me/abc123

Go, mit der Standardbibliothek:

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]string{
		"destination_url": "https://example.com/spring-sale",
	})
	req, _ := http.NewRequest("POST", "https://api.elido.app/v1/links", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("ELIDO_TOKEN"))
	req.Header.Set("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	var link struct {
		ShortURL string `json:"short_url"`
	}
	json.NewDecoder(res.Body).Decode(&link)
	fmt.Println(link.ShortURL) // https://s.elido.me/abc123
}

Fügen Sie dem Body optionale Felder hinzu, wenn Sie sie brauchen: einen slug für eine benutzerdefinierte Endung, tags zur Organisation, eine domain, um eine Branded-Custom-Domain zu wählen, oder expires_at für einen Link, der nach einem Datum aufhört zu funktionieren.

Was „kostenlos" tatsächlich einschränkt

Hier liegt der ehrliche Vergleich, denn „kostenlose API" umfasst zwei sehr unterschiedliche Dinge.

Die anmeldungsfreien, authentifizierungsfreien Endpunkte, jene, die eine URL mit einem einzigen unauthentifizierten POST kürzen, sind echt kostenlos und echt eingeschränkt. Gemeinsam genutzte Rate-Limits, kein Konto, keine Branded-Domain, keine Analysen und kein Versprechen, dass der Dienst nächstes Quartal noch existiert. In Ordnung für ein einmaliges Skript, riskant für alles, was Sie ausliefern.

Eine authentifizierte kostenlose Stufe ist die nützlichere Art, und dort ist die Einschränkung vorhersehbar. Die Funktionen, die am häufigsten bezahlten Plänen vorbehalten sind, sind Branded-Custom-Domains, hohes Anfragevolumen, längere Analyse-Aufbewahrung und Bulk-Endpunkte. Im kostenlosen Plan von Elido ist die API selbst enthalten, Links werden aufgelöst und verfolgt, und die Limits sind Workspace-gebunden statt mit Fremden geteilt. Wie die bezahlten Tools hier abschneiden, deckt Dub vs. Bitly für zwei der bekanntesten APIs ab, und Sie können im kostenlosen Plan starten, um Elidos auszuprobieren.

Die Faustregel: Wenn der Link wegwerfbar ist, ist eine API ohne Auth in Ordnung. Wenn er Ihre Marke trägt oder Sie ihn messen müssen, verwenden Sie eine authentifizierte mit einer Domain, die Sie kontrollieren.

Rate-Limits und Idempotenz

Die Zahl, die Sie in Produktion tatsächlich schützt, ist nicht das Rate-Limit, es ist die Idempotenz.

Jede verändernde Anfrage akzeptiert einen Idempotency-Key-Header. Senden Sie einen eindeutigen Schlüssel mit einem Create-Aufruf, und wenn die Anfrage einen Timeout hat und Sie mit demselben Schlüssel erneut versuchen, gibt der Server das ursprüngliche Ergebnis zurück, statt einen zweiten Link zu erstellen. Das ist es, was eine Retry-Schleife sicher macht.

curl -X POST https://api.elido.app/v1/links \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Idempotency-Key: spring-sale-2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/spring-sale"}'

Idempotenz ist eine Eigenschaft der HTTP-Methodensemantik in RFC 9110, und jede API, auf die Sie sich für automatisierte Link-Erstellung verlassen, sollte das unterstützen. Die tiefere Behandlung, welche Statuscodes man erneut versuchen sollte und wie man das Tempo gegen das Limit abstimmt, steht in Rate-Limits, Retries und Idempotenz in Produktion.

SDKs oder rohes HTTP?

Sie müssen Anfragen nicht von Hand bauen. Elido veröffentlicht SDKs, generiert aus seiner OpenAPI-Spezifikation, für TypeScript, Python, Go und mehr, und der API- und SDK-Schnelleinstieg führt durch deren Installation und Aufruf.

Verwenden Sie ein SDK, wenn Sie Typen, Retries und Pagination für sich erledigt haben wollen. Verwenden Sie rohes HTTP, wie in den Beispielen oben, wenn Sie null Abhängigkeiten wollen oder aus einer Sprache ohne offiziellen Client aufrufen. Beide treffen dieselbe REST-API; das SDK ist nur ein dünnerer Pfad dorthin.

Verwandte Beiträge im Blog

• URL-Shortener-API- und SDK-Schnelleinstieg
• Rate-Limits, Retries und Idempotenz in Produktion
• Wie man eine URL kürzt: kostenlose, Branded- und Bulk-Links
• Dub vs. Bitly: Preise, kostenlose Pläne und Funktionen