QRCodeTransfer

Eine QR-Code-API für verwaltete Kampagnenressourcen

Erstellen Sie Ressourcen, ändern Sie Ziele und lesen Sie Berichte, ohne Arbeitsbereichsrechte oder Tarifgrenzen zu umgehen.

API-Token abrufen
Als Markdown anzeigen
requests.post(
  'https://qrcodetransfer.com/api/v1/workspaces/ID/assets',
  headers={'Authorization': 'Bearer YOUR_KEY'},
  json=data,
  timeout=10
)
QR-Code-Beispiel

DOCEinführung

Bauen Sie Ihren Ablauf auf QR-Codes, Kurzlinks, Seiten, Formularen und GS1-Links des Arbeitsbereichs auf. Die API verwendet dieselben Eigentumsprüfungen, Eingabevalidierungen und Kontingente wie der Benutzerbereich. Beginnen Sie mit einer Testressource, bevor Sie einen Stapel automatisieren.

Basis-URL

https://qrcodetransfer.com/api/v1/

Daten bleiben privat. Jede Anfrage prüft Arbeitsbereich und Rechte des Nutzers oder API-Schlüssels.

AUTHAuthentifizierung

Erstellen Sie bei entsprechendem Tarif einen API-Schlüssel und speichern Sie ihn serverseitig. Er gehört zu einem Arbeitsbereich mit Lese- oder Schreibrechten.

Authorization: Bearer YOUR_API_KEY

QRQR-Codes

Dynamische Codes behalten die Druckadresse bei Zieländerungen. Statische Codes enthalten den Inhalt direkt und erlauben keine Zieländerung.

POST /api/v1/workspaces/WORKSPACE_ID/assets

{
  "kind": "QRCODE",
  "name": "Spring campaign",
  "payload": {
    "type": "LINK",
    "url": "https://example.com/campaign",
    "dynamic": true
  }
}

PDFPDF-Codes

Laden Sie eine PDF hoch und erstellen Sie den Code mit ihrer Kennung. Die alte Version bleibt bis zur Ressourcenaktualisierung verfügbar. Unveröffentlichte Dateien erfordern Anmeldung.

POST /api/v1/workspaces/WORKSPACE_ID/files
Content-Type: multipart/form-data

POST /api/v1/workspaces/WORKSPACE_ID/assets
{ "kind": "QRCODE", "name": "Product guide",
  "payload": { "type": "PDF", "fileId": 123, "dynamic": true } }

PAGELandingpages

Seiten beginnen als Entwurf. Ergänzen Sie Titel und Links und veröffentlichen Sie. Entwurfsänderungen werden erst nach erneuter Veröffentlichung öffentlich.

POST /api/v1/workspaces/WORKSPACE_ID/assets
{ "kind": "PAGE", "name": "Our links", "payload": {
  "title": "Our links",
  "links": [{ "label": "Website", "url": "https://example.com" }]
} }

POST /api/v1/workspaces/WORKSPACE_ID/assets/ASSET_ID/actions/publish

FORMFormulare

Antworten speichern die veröffentlichten Felder. Nutzen Sie Feldkennungen. Ein Idempotenzschlüssel liefert bei Wiederholung das ursprüngliche Ergebnis. Geschlossene Formulare bleiben sichtbar, nehmen aber keine Antworten an.

POST /api/public/forms/FORM_SLUG/submissions
{ "answers": { "email": "[email protected]" },
  "idempotencyKey": "submission-unique-id" }

GS1GS1 Digital Link

Produktcodes enthalten Anwendungskennungen in der URI. Prüfen Sie sie vor dem Druck. Die Produktidentität bleibt bei Zieländerungen gleich. Testen Sie den Code im Verkaufs- und Verpackungsablauf.

POST /api/v1/workspaces/WORKSPACE_ID/assets
{ "kind": "GS1", "name": "Product", "payload": {
  "identifierType": "01", "identifierValue": "09506000134369",
  "destinationUrl": "https://example.com/product"
} }

BULKMassenerstellung

Prüfen Sie jede Zeile. Vorschauen zeigen ungültige URLs und reservierte Pfade. Nutzen Sie bei Wiederholung dieselbe Idempotency-Key, um Duplikate zu vermeiden.

POST /api/v1/workspaces/WORKSPACE_ID/bulk/preview
POST /api/v1/workspaces/WORKSPACE_ID/bulk/execute
Idempotency-Key: unique-batch-id

{ "kind": "SHORTLINK", "rows": [
  { "name": "Launch", "url": "https://example.com/launch" }
] }

HOOKWebhooks

Besitzer verwalten Webhooks bei passendem Tarif. Zustellung muss aktiviert und eingerichtet sein. Protokolle zeigen das Ergebnis; ein gespeicherter Endpunkt bedeutet noch keine gesendete Nachricht.

HTTPFehler und Status

Fehler enthalten Code, Meldung und Felddetails. 401: Anmeldung nötig; 403: Zugriff verweigert; 409: Konflikt bei Status, Version, Pfad, Kontingent oder Idempotenz; 422: ungültige Eingabe; 503: Dienst nicht verfügbar. Pausierte oder gesperrte Codes liefern 410.

MCPMCP-Integration

Verbinden Sie HTTP-MCP mit dem API-Schlüssel. Der zustandslose Endpunkt liefert JSON und fünf Werkzeuge: Auflisten, Lesen, Erstellen, Ändern und Analyse. Schreibzugriff ist erforderlich. Gehostete Clients und direkte Anmeldung werden noch geprüft.

POST /api/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }
Hilfe