Aller au contenu
DÉVELOPPEURS & API

Construire sur Zinevu.

Intégrez Zinevu dans votre stack, intégrez le configurateur 3D n'importe où, ou automatisez votre workflow avec des webhooks et notre API REST.

API REST

Une API propre pour de vraies intégrations.

Chaque ressource dans Zinevu — devis, clients, projets, factures — est accessible via une API REST avec des réponses JSON prévisibles et une authentification OAuth 2.0.

  • JSON via HTTPS avec des codes d'erreur cohérents

  • Identifiants client OAuth 2.0 pour l'auth serveur à serveur

  • Portées par ressource — demandez uniquement ce dont vous avez besoin

  • Limite : 1 000 requêtes / minute par clé

  • Environnement sandbox pour des tests sécurisés

GET /v1/quotes
curl https://api.zinevu.com/v1/quotes \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json"

# Response
{
  "data": [
    {
      "id": "q_01j9abc123",
      "status": "sent",
      "total": 8740.00,
      "currency": "EUR",
      "customer": {
        "name": "Jan de Vries",
        "email": "[email protected]"
      },
      "created_at": "2026-08-10T09:32:11Z"
    }
  ],
  "meta": {
    "total": 147,
    "page": 1,
    "per_page": 25
  }
}
index.html
<!-- Paste it where the widget should appear -->
<script src="https://app.zinevu.com/w.js" async
        data-zv="YOUR_FORM_SLUG"
        data-widget="size"
        data-url="https://offerte.yourcompany.nl/q/YOUR_FORM_SLUG"></script>

Remplacez YOUR_FORM_SLUG par le slug du formulaire de demande, disponible dans le portail revendeur.

Guide d’installation complet
WIDGET

Placez le configurateur sur n’importe quelle page.

Une ligne de script place le configurateur du revendeur sur son propre site, à ses propres couleurs. Sept variantes — de la question de dimensions au formulaire complet — et le visiteur arrive dans le tunnel avec ce qu’il a déjà renseigné. Aucun framework, aucune étape de build, aucun cookie.

WEBHOOKS

Réagissez aux événements en temps réel.

Abonnez-vous aux événements — devis envoyé, devis signé, projet créé, facture payée — et transmettez-les à vos propres systèmes, CRM ou entrepôt de données.

quote.createdquote.sentquote.signedquote.expiredproject.createdproject.updatedproject.completedinvoice.createdinvoice.paidpayment.failedlead.createdconfigurator.completed
OBTENIR L'ACCÈS

L'accès API est disponible dans les plans Growth et Enterprise.

Contactez notre équipe de support pour commencer. Nous configurerons vos clés API, vous guiderons dans le sandbox et partagerons la documentation de référence complète de l'API.

Envoyer un e-mail à l'équipe support[email protected]

Nous répondons généralement dans un délai d'un jour ouvrable.