Linkgruppen aktualisieren API

Verwalten und aktualisieren Sie mehrere Kurzlinks gleichzeitig über Gruppen.

Passen Sie Einstellungen auf Gruppenebene an, um Kampagnen effizient zu steuern, und aktualisieren Sie gemeinsame Optionen wie Ablaufdatum, Passwortschutz und Webhooks zentral.

Änderungen an den Gruppeneinstellungen werden auf alle enthaltenen Links angewendet.
Bei Konflikten zwischen Einzel- und Gruppeneinstellungen gelten die Gruppeneinstellungen.

PUT

/api/link-group/v1/update 

{
    "grpIdx": 5066,
    "nm": "Instagram Group",
    "memo": "A group of links used in Instagram ads.",
    "strtYmdt": "2026-03-01 00:00:00",
    "endYmdt": "2026-03-31 23:59:59",
    "expireUrl": "https://example.com/event-expired"
}

Request Parameters

grpIdx integer required
Gruppen-IDX.
Geben Sie den IDX der Gruppe an, die aktualisiert werden soll.
nm string
Name der Gruppe.
Legt den Namen der Gruppe fest, mit der Links organisiert und verwaltet werden.
memo string
Interne Notiz zur Gruppenverwaltung.
Hier können Sie den Zweck der Gruppe oder administrative Informationen frei dokumentieren.
notfSubscYn string
Default:N
Enum:
YN
Legt fest, ob der Link als Push-Benachrichtigungs-Abonnementlink erstellt wird.
Y: Erstellt einen Link speziell für Push-Benachrichtigungs-Abonnements.
N: Erstellt einen normalen Link.
Beim Aufruf eines solchen Links wird dem Benutzer eine Anfrage zur Browser-Push-Benachrichtigung angezeigt.
qrBypassYn string
Default:N
Enum:
YN
Definiert das Weiterleitungsverhalten bei Zugriff über einen QR-Code.
Y: Leitet direkt zur ursprünglichen URL weiter. (Klickstatistiken werden nicht erfasst)
N: Leitet über die Kurz-URL weiter. (Klickstatistiken werden erfasst)
blockOverseasSticsYn string
Default:N
Enum:
YN
Legt fest, ob Zugriffe aus dem Ausland von der Statistik ausgeschlossen werden.
Y: Zugriffe aus dem Ausland werden nicht in der Statistik berücksichtigt.
N: Zugriffe aus allen Ländern werden in der Statistik erfasst.
pushNotifyYn string
Default:N
Enum:
YN
Legt fest, ob Push-Benachrichtigungen basierend auf der Klickanzahl gesendet werden.
Y: Eine Push-Benachrichtigung wird gesendet, sobald der definierte Schwellenwert erreicht ist.
N: Es werden keine Push-Benachrichtigungen gesendet.
Diese Funktion ist ab dem Personal-Tarif verfügbar.
mailNotifyYn string
Default:N
Enum:
YN
Legt fest, ob E-Mail-Benachrichtigungen basierend auf der Klickanzahl gesendet werden.
Y: Eine E-Mail wird gesendet, sobald der definierte Schwellenwert erreicht ist.
N: Es werden keine E-Mails gesendet.
Diese Funktion ist ab dem Personal-Tarif verfügbar.
nonmemberSticsPwd string
Passwort zum Anzeigen der Klickstatistiken für nicht registrierte Benutzer.
Wenn Sie Statistikdaten auch für nicht registrierte Benutzer freigeben möchten, legen Sie hier das Passwort fest, das für den Zugriff auf die Statistikseite erforderlich ist.
strtYmdt datetime
Startdatum und -zeit der Linkgültigkeit.
Der Link kann erst ab dem angegebenen Zeitpunkt aufgerufen werden.
Beispiel: 2026-03-01 00:00:00
endYmdt datetime
Ablaufdatum und -zeit des Links.
Nach diesem Zeitpunkt wird der Zugriff auf den Link blockiert.
Beispiel: 2026-03-31 23:59:59
expireUrl string
URL, zu der Benutzer nach Ablauf des Links weitergeleitet werden.
Wenn kein Wert gesetzt ist, wird eine Standard-Hinweisseite angezeigt.
Beispiel: https://example.com/event-expired
pwd string
Passwort zum Zugriff auf den Link.
Wenn ein Passwort gesetzt ist, müssen Benutzer dieses eingeben, bevor sie auf die Zielseite weitergeleitet werden.
acesMaxCnt integer
Maximal zulässige Anzahl von Klicks.
Wird das festgelegte Limit überschritten, wird der Zugriff auf den Link blockiert. (0 bedeutet unbegrenzt)
webhookEnableYn string
Default:N
Enum:
YN
Legt fest, ob Webhooks aktiviert sind.
Der globale Webhook muss zuvor aktiviert sein.
Diese Funktion ist nur im Enterprise-Tarif verfügbar.
webhookCallbackUrl string
Server-URL, die Webhook-Events empfängt.
Erforderlich, wenn webhookEnableYn den Wert Y hat. Geben Sie den Endpoint Ihres Servers an, der Eventdaten empfängt.
Beispiel: https://api.example.com/webhook
webhookMetric string
Default:C
Enum:
CP
Kriterium zur Auslösung des Webhooks.
C: basierend auf Klickanzahl, P: basierend auf Benutzeranzahl (eindeutige Klicks)
webhookFrequency integer
Default:1
Enum:
1501002003005001000
Häufigkeit der Webhook-Auslösung.
1: bei jedem Klick, 50: alle 50 Klicks, 100: alle 100 Klicks, 300: alle 300 Klicks, 500: alle 500 Klicks, 1000: alle 1.000 Klicks 
{
    "code": 0,
    "message": "",
    "result": null  // When the ‘webhookEnableYn’ parameter is set to ‘Y’, a secret key is specified.
}

Response Parameters

code integer
Antwortcode: 0 = Erfolg, andere Werte = Fehler
message string
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
result string
Wenn webhookEnableYn auf Y gesetzt ist, wird ein secret key generiert und zurückgegeben.
Existiert bereits ein webhookSecretKey für die Gruppe, wird kein neuer Schlüssel generiert oder zurückgegeben.

Wann diese API verwenden

Diese API ist ideal, wenn die Verwaltung einzelner Kurzlinks zu aufwendig wird.

  • Mehrere Kampagnenlinks gleichzeitig deaktivieren oder deren Laufzeit anpassen
  • Den Zugriff auf alle Links nach einem bestimmten Ereignis einschränken
  • Gleiche Einstellungen auf mehrere Links gleichzeitig anwenden
Die Verwaltung auf Gruppenebene reduziert den Aufwand im Vergleich zur Einzelbearbeitung deutlich.

Zentrale Funktionen und Auswirkungen der Einstellungen

Diese API geht über einfache Änderungen hinaus und steuert das Verhalten Ihrer Kurzlinks.

Zugriffskontrolle

  • Zugriff für nicht registrierte Nutzer einschränken
  • QR-Code-Zugriff begrenzen → nur für ausgewählte Nutzer freigeben

Analyse und Filterung

  • Bot-Traffic ausschließen → verbessert die Datenqualität

Benachrichtigungen

  • Push- und E-Mail-Benachrichtigungen → Reaktion in Echtzeit

Zeitsteuerung

  • Start- und Enddatum festlegen → automatische Aktivierung/Deaktivierung

Ablaufverwaltung

  • Weiterleitung nach Ablauf → bessere Nutzererfahrung

Webhooks

  • Daten an externe Server senden → Integration und Automatisierung

Anwendungsfälle

  • Marketingkampagnen: Alle Links bei Kampagnenende deaktivieren und automatisch auf eine Ablauf-URL weiterleiten
  • SaaS-Plattformen: Links nach Funktionen gruppieren und Zugriff sowie Laufzeiten zentral verwalten
  • Verwaltung großer Linkmengen: Webhooks nutzen, um Klickereignisse in Echtzeit mit internen Systemen zu synchronisieren
  • Sicherheit: Sicherheit durch regelmäßigen Passwortwechsel gewährleisten

Wichtige Hinweise

  • Änderungen an Gruppeneinstellungen gelten sofort für alle Links
  • Fehlerhafte Datumseinstellungen können den Zugriff auf alle Links einschränken
  • Webhook-Übertragungen können je nach Verfügbarkeit externer Server verzögert sein
  • Änderungen an Analysefiltern können die Interpretation vorhandener Daten beeinflussen