Documentation de l'API InterVizio

L'API InterVizio est une API REST qui renvoie les données de votre organisation au format JSON. Chaque clé est cloisonnée : elle n'accède qu'aux données de l'organisation qui l'a émise.

Chaque clé porte deux niveaux d'autorisation, choisis à la création :

• Ressources : accès complet, ou restreint à certaines (ex. seulement les factures, ou les clients).
• Opérations : Lecture (toujours), Création et/ou Modification.

Pour obtenir une clé : dans l'application, Réglages → API & Développeurs → Générer une clé(réservé aux administrateurs de l'organisation sur le pack Grand Compte ; chaque création/suppression est protégée par la double authentification 2FA).

Chaque requête doit inclure votre clé API dans l'en-tête x-api-key :

x-api-key: iv_live_votre_cle_ici

L'en-tête Authorization: Bearer iv_live_… est également accepté. Ne partagez jamais votre clé publiquement (elle donne accès à vos données).

Toutes les URL sont préfixées par :

https://api.intervizio.fr/v1

Une liste renvoie un objet data (tableau) + pagination :

{
  "data": [ { "id": "…", "reference": "INT-0433", "status": "completed", … } ],
  "pagination": { "limit": 50, "offset": 0, "total": 433 }
}

Un accès par identifiant renvoie { "data": { … } }. Une erreur renvoie { "error": "…" } avec le code HTTP correspondant.

Toutes ces ressources sont disponibles. La dernière colonne indique seulement si le paramètre ?status peut filtrer cette ressource — « Non » ne veut pas dire indisponible.

Exemple : les 10 dernières interventions terminées

GET https://api.intervizio.fr/v1/interventions?status=completed&limit=10

Exemple : relevé d'un client sur une période

GET https://api.intervizio.fr/v1/clients/{id}/statement?start=2026-01-01&end=2026-06-30

Exemple : relevé d'un sous-traitant

GET https://api.intervizio.fr/v1/subcontractors/{id}/statement?start=2026-07-01&end=2026-09-30

Une sous-ressource inconnue renvoie désormais 404, et non plus la fiche de la ressource en 200 : une API qui répond « oui » à une route absente ne se débogue pas.

Disponible pour clients, sites, demandes, interventions, avec une clé disposant de l'opération Création et/ou Modification. Corps au format JSON.

Champs requis à la création : clients/sites → name ; demandes → title, client_id ; interventions → title.

Créer un client (cURL)

curl -X POST -H "x-api-key: iv_live_..." -H "Content-Type: application/json" \
  -d '{"name":"Nouveau client","city":"Paris","email":"contact@client.fr"}' \
  "https://api.intervizio.fr/v1/clients"

Modifier un client (cURL)

curl -X PUT -H "x-api-key: iv_live_..." -H "Content-Type: application/json" \
  -d '{"phone":"0102030405"}' \
  "https://api.intervizio.fr/v1/clients/{id}"

cURL

curl -H "x-api-key: iv_live_..." \
  "https://api.intervizio.fr/v1/interventions?limit=10"

JavaScript (fetch)

const res = await fetch(
  "https://api.intervizio.fr/v1/interventions?limit=10",
  { headers: { "x-api-key": "iv_live_..." } }
);
const { data, pagination } = await res.json();
console.log(pagination.total, data);

Python (requests)

import requests

r = requests.get(
    "https://api.intervizio.fr/v1/interventions",
    headers={"x-api-key": "iv_live_..."},
    params={"limit": 10, "status": "completed"},
)
data = r.json()["data"]
print(data)