ViaVeg - API & Integracje

Schnellstart

Fügen Sie ?type=json zu Ihrem Teilnehmerlink hinzu, um JSON anstelle der HTML-Ansicht zu erhalten.

curl "https://viaveg.com/p/{YOUR_TOKEN}?type=json"

Endpunkt

GET

/p/{token}?type=json

Liefert die Sendung, aktuelle Phase, Teilnehmerdaten und alle Einträge (Checklisten / QK), die aus Ihrer Rolle sichtbar sind.

Beispielantwort

{
  "shipment": {
    "id": 35,
    "reference": "VG-00035",
    "cargo_name": "Brokuł 150kg",
    "cargo_quantity": 150,
    "cargo_unit": "kg",
    "pickup_address": "...",
    "delivery_address": "...",
    "status": "in_progress",
    "certified": false
  },
  "phase": {
    "id": 89,
    "name": "loading",
    "status": "active",
    "location": "...",
    "started_at": "2026-04-17T07:00:00+00:00",
    "completed_at": null
  },
  "participant": {
    "id": 98,
    "role": "producer",
    "name": "...",
    "email": "..."
  },
  "entries": [
    {
      "id": 42,
      "type": "checklist",
      "status": "draft",
      "template": {
        "name": "Checklist załadunku",
        "fields": [
          {"key": "temperature_before", "label": "Temperatura", "type": "number", "hint": "°C"}
        ]
      },
      "data": {
        "temperature_before": "4.2"
      },
      "completed_at": null,
      "created_at": "2026-04-17T09:00:00+00:00",
      "updated_at": "2026-04-17T19:24:00+00:00"
    }
  ],
  "generated_at": "2026-04-17T20:30:00+00:00"
}

Authentifizierung

Das Link-Token ist der Schlüssel — jede Rolle erhält ihre eigene eindeutige URL.

Token besteht aus 64 Zeichen, generiert beim Einladen eines Teilnehmers.
Behandeln Sie den Link wie ein Passwort — wer ihn hat, sieht die Daten.
Der Distributor kann den Zugriff über „Teilnehmer deaktivieren" widerrufen.

Postman-Kollektion

Laden Sie eine fertige Postman 2.1-Kollektion herunter — Token setzen und sofort loslegen.

Postman-Kollektion herunterladen

Beispiele

Python

import requests
r = requests.get("https://viaveg.com/p/YOUR_TOKEN", params={"type": "json"})
data = r.json()
for entry in data["entries"]:
    print(entry["type"], entry["status"], entry["data"])

Node.js

const res = await fetch("https://viaveg.com/p/YOUR_TOKEN?type=json");
const data = await res.json();
console.log(data.shipment, data.entries);

API & Integrationen