POST /api/v1/links/bulk
Senden Sie ein items- oder links-Array mit höchstens 100 Einträgen.
Entwickleranleitung
Kurzlinks stapelweise mit der tt.vg-API erstellen
Nutzen Sie den Bulk-Endpunkt, verarbeiten Sie Teilerfolge, wiederverwenden Sie Idempotenzschlüssel und verbinden Sie Webhooks.
links:bulk:create
Der API-Schlüssel benötigt die Berechtigung zur Bulk-Erstellung.
Idempotency-Key
Verwenden Sie für Wiederholungen desselben Stapels dieselbe UUID, um Duplikate zu vermeiden.
Kopieren und anpassen
Beispiele für curl, JavaScript und Python
Ersetzen Sie API-Schlüssel und Ziele. Jeder Eintrag akzeptiert die Felder der Einzel-API.
curl -X POST https://tt.vg/api/v1/links/bulk \
-H "Authorization: Bearer ttvg_your_api_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
-d '{
"items": [
{ "destinationUrl": "https://example.com/a", "description": "Campaign A" },
{ "destinationUrl": "https://example.com/b", "key": "campaign-b" }
]
}'Antwortverarbeitung
Jedes Ergebnis einzeln behandeln
Ein Stapel kann erfolgreiche Links und Fehler enthalten. Speichern Sie den zurückgegebenen Index mit Ihrer Eingabe.
Alle Einträge erfolgreich
Lesen Sie items und summary; errors ist leer.
Teilerfolg
Speichern Sie erfolgreiche Einträge und wiederholen Sie nur die fehlerhaften Eingaben.
Anfrage- oder Zugriffsfehler
Beheben Sie Validierung, Anmeldung, E-Mail-Prüfung oder Berechtigungen.
Quote oder Ratenlimit
Stoppen und warten Sie; beachten Sie Retry-After, falls vorhanden.
Vorübergehender Serverfehler
Wiederholen Sie exponentiell verzögert mit derselben Idempotency-Key.
Quoten und Stapelgrenzen
Eine Anfrage enthält höchstens 100 Links. Jeder Erfolg verbraucht eine tägliche links:create-Einheit des Tarifs; Fehler nicht.
Mit Webhooks fortfahren
Abonnieren Sie link.created, link.updated oder link.clicked. Signierte Zustellung erfolgt asynchron und wird wiederholt, ohne die API zu blockieren.
Häufige Fragen
Fragen zur Bulk-API
Ist die Bulk-Erstellung vollständig atomar?
Nein. Gültige Einträge können erfolgreich sein, während andere indexierte Fehler liefern; gemischte Ergebnisse verwenden HTTP 207.
Was passiert, wenn die Quote im Stapel endet?
Der aktuelle und alle verbleibenden Einträge erhalten 429, dann stoppt die Verarbeitung.
Wie verhindere ich Duplikate bei Wiederholungen?
Senden Sie eine zufällige Idempotency-Key und verwenden Sie sie nur für denselben Stapel erneut.