API

Commandez depuis votre logiciel, ou connectez votre atelier d'impression à la file de production. Authentification par clé (Authorization: Bearer vk_…), créée dans votre espace. Réponses JSON { success, data, error }. Description complète : OpenAPI.

Points d'accès

Méthode	Chemin	Clé	Rôle
GET	/api/v1/poseurs?departement=69	Pro	Poseurs vérifiés du département
POST	/api/v1/commandes	Pro	Crée une commande, renvoie le lien de paiement de l'acompte
GET	/api/v1/commandes	Pro	Vos commandes
GET	/api/v1/commandes/{id}	Pro	Statut, montants, factures
GET	/api/v1/production	Poseur / atelier	Commandes à produire et fichiers
GET	/api/v1/production/{id}/lignes/{n}/{dossier\|pdf\|epreuve}	Poseur / atelier	Fichiers de production
POST	/api/v1/production/{id}/{accepter\|refuser\|epreuve-remise\|pose-terminee}	Poseur / atelier	Avancement

Passer une commande (compte pro)

curl -X POST "$BASE/api/v1/commandes" \
  -H "Authorization: Bearer vk_xxxxxxxx_…" -H "Content-Type: application/json" \
  -d '{
    "vehicules": [{
      "vehicule": { "plaque": "AB-123-CD" },
      "motif": { "catalogue": "bandeau", "couleurs": ["#ffffff", "#0057b8", "#111111"] },
      "calques": [
        { "kind": "texte", "id": "nom", "face": "flancs", "x": 0.5, "y": 0.45,
          "text": "Dupont Plomberie", "fontId": "archivo-black", "color": "#111111", "sizeMm": 180 },
        { "kind": "qrcode", "id": "qr", "face": "arriere", "x": 0.5, "y": 0.6,
          "content": "https://dupont-plomberie.fr", "color": "#111111", "widthMm": 250 }
      ],
      "quantite": 3
    }],
    "client": { "name": "Jean Dupont", "email": "jean@dupont.fr", "phone": "0611223344" },
    "adressePose": { "address": "12 rue de la Pose", "postcode": "69003", "city": "Lyon" },
    "poseurId": "…",
    "epreuve": true,
    "bonATirerValide": true
  }'

Connecter un atelier d'impression (compte poseur)

# Commandes à produire
curl "$BASE/api/v1/production" -H "Authorization: Bearer vk_…"

# Dossier complet d'une ligne (PDF + SVG) : redirection vers un lien signé 7 jours
curl -L -o dossier.zip "$BASE/api/v1/production/<id>/lignes/1/dossier" -H "Authorization: Bearer vk_…"

# Épreuve d'essai, puis déclaration de remise
curl -o epreuve.pdf "$BASE/api/v1/production/<id>/lignes/1/epreuve" -H "Authorization: Bearer vk_…"
curl -X POST "$BASE/api/v1/production/<id>/epreuve-remise" -H "Authorization: Bearer vk_…"

Règles

Les prix sont toujours recalculés par le serveur. 60 requêtes par minute et par clé.

Avec une épreuve d'essai, les fichiers de production restent verrouillés (409) jusqu'à la validation du client.

Le bon à tirer (bonATirerValide) engage le client : design, textes et dimensions sont imprimés tels quels.