API & Integracje

Pobieraj dane ze swojej przesyłki jako JSON — podepnij do Zapiera, n8n, własnego ERP.

Szybki start

Dodaj ?type=json do swojego linku uczestnika, żeby zamiast widoku dostać JSON.

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

Endpoint

GET

/p/{token}?type=json

Zwraca przesyłkę, bieżącą fazę, dane uczestnika i wszystkie wpisy (checklisty / QC) widoczne z poziomu Twojej roli.

Przykładowa odpowiedź

{
  "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"
}

Autoryzacja

Token w linku pełni rolę klucza — każda rola dostaje własny unikalny URL.

Token to 64 znaki, generowany przy zapraszaniu uczestnika.
Nie publikuj linku — kto go ma, ten widzi dane.
Organizator może odwołać dostęp przez „Dezaktywuj uczestnika".

Kolekcja Postman

Pobierz gotową kolekcję 2.1 — ustaw token i od razu testuj.

Pobierz kolekcję Postman

Przykłady

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);

Masz pytania? mzoladkowicz@gmail.com