Kurzlinks

Kurzlinks in einem Projekt erstellen und verwalten.

GET /shorts/availability

Verfügbarkeit von short_name prüfen

Prüft, ob die Kombination Host + `short_name` frei ist, bevor ein Link erstellt wird.

Verhalten

Fehler: 400 (Validierung), 404 (`subdomain_not_found_error`), 403 (API-Schlüssel-Berechtigungen).

Query-Parameter

Antworten

DELETE /shorts/bulk

Kurzlinks massenhaft löschen

Löscht die aufgelisteten Kurzlinks in einer Anfrage.

Verhalten

HTTP 204 — alle gelöscht; HTTP 207 — teilweises Löschen (siehe `errors`).

Anfragekörper (JSON)

Antworten

PATCH /shorts/bulk

Kurzlinks massenhaft aktualisieren

Aktualisiert mehrere Kurzlinks in einer Anfrage.

Verhalten

Anfragekörper (JSON)

Antworten

GET /shorts/{scope_id}

Kurzlinks auflisten

Gibt Kurzlinks im angegebenen Scope mit optionaler Filterung zurück.

Verhalten

Boolesche Flags (`with_password`, `with_captcha`, `with_expiration`, `with_beginning`, `with_max_clicks`, `with_budget`) wählen Links mit/ohne diese Einschränkungen. `tags_mode`: `any` oder `all`. Archiv ist standardmäßig ausgeblendet — übergeben Sie `is_archived=true`, um es einzubeziehen. Antwort 200.

Pfadparameter

Query-Parameter

Antworten

POST /shorts/{scope_id}

Kurzlink erstellen

Erstellt einen Kurzlink im angegebenen Scope.

Verhalten

Pfadparameter

Anfragekörper (JSON)

Antworten

POST /shorts/{scope_id}/bulk

Kurzlinks massenhaft erstellen

Erstellt mehrere Kurzlinks in einer Anfrage.

Verhalten

HTTP 201 — alle erstellt; HTTP 207 — Teilerfolg (siehe `errors`).

API — alle Abschnitte · Dokumentation