API & Intégrations

Récupérez les données de votre expédition au format JSON — connectez à Zapier, n8n ou votre propre ERP.

Démarrage rapide

Ajoutez ?type=json à votre lien de participant pour recevoir du JSON au lieu de la vue HTML.

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

Endpoint

GET

/p/{token}?type=json

Renvoie l'expédition, la phase en cours, les informations du participant et chaque entrée (liste de contrôle / CQ) visible depuis votre rôle.

Exemple de réponse

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

Authentification

Le jeton dans le lien fait office de clé — chaque rôle dispose de sa propre URL unique.

Le jeton fait 64 caractères, généré lors de l'invitation d'un participant.
Traitez le lien comme un mot de passe — quiconque le possède voit les données.
Le distributeur peut révoquer l'accès via « Désactiver le participant ».

Collection Postman

Téléchargez une collection Postman 2.1 prête à l'emploi — définissez le jeton et commencez à appeler.

Télécharger la collection Postman

Exemples

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

Des questions ? mzoladkowicz@gmail.com