Aller au contenu

Environnements et bac à sable

Le bac à sable est ouvert dès la création du compte, sans carte ni crédit. Il utilise la même URL (https://app.vitef.com) et les mêmes routes que la production : seule la clé change.

Ce qui change avec une clé test

  • Rien n’est posté ni facturé : l’envoi porte test: true et amountCents: 0, avec un numéro de suivi fictif.
  • Les preuves (dépôt, accusé de réception) sont des PDF fictifs, marqués comme tels.
  • L’IA renvoie un texte simulé : vous testez l’intégration, pas la rédaction.
  • Catalogue, rendu de lettre, PDF, calculateurs, annuaire et carburants renvoient les vraies données.
  • Les webhooks test sont réellement envoyés à votre URL, signés comme en production.
  • Quota : 1 000 appels par jour et par compte, en plus de la limite de débit. Au-delà : 429 test_quota_exceeded.

Faire avancer un envoi de test

POST/v1/test/mailings/{id}/advanceclé test seulement

Sans corps, l’envoi passe à l’étape suivante. Avec to, il saute à l’étape demandée : printed, posted, in_transit, delivered, ar_signed, returned ou error. Les preuves fictives apparaissent comme en production (preuve de dépôt à la remise à La Poste, accusé de réception à la signature) et chaque étape déclenche ses webhooks.

Requête
curl -X POST "https://app.vitef.com/v1/test/mailings/e1209b63-3764-49e3-bf9c-154e9be830da/advance" \
  -H "Authorization: Bearer $VITEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "posted"
}'
Réponse 200
{
  "title": "Lettre de résiliation SFR",
  "mode": "ar",
  "modeLabel": "Recommandé avec AR",
  "status": "posted",
  "statusLabel": "Remise à La Poste",
  "step": 2,
  "lastStep": 5,
  "trackingNumber": "1A15760000001",
  "createdAt": "2026-09-23T10:00:00.000Z",
  "events": [
    {
      "step": 0,
      "status": "paid",
      "label": "Payée",
      "at": "2026-09-23T10:00:00.000Z"
    },
    {
      "step": 1,
      "status": "printed",
      "label": "Imprimée",
      "at": "2026-09-23T10:00:00.000Z"
    },
    {
      "step": 2,
      "status": "posted",
      "label": "Remise à La Poste",
      "at": "2026-09-23T10:00:00.000Z"
    }
  ],
  "id": "e1209b63-3764-49e3-bf9c-154e9be830da",
  "orderId": null,
  "recipient": [
    "SFR Résiliation",
    "TSA 30103",
    "69947 Lyon Cedex 20"
  ],
  "amountCents": 0,
  "reference": "BAIL-2026-042",
  "test": true,
  "proofs": [
    {
      "kind": "filing",
      "label": "Preuve de dépôt"
    }
  ]
}

Envoi déjà à sa dernière étape : 409 conflict. Avec une clé live : 403 test_only.

Passer en production

  1. Demandez l’ouverture de la production dans l’espace développeur : SIREN, adresse du siège, TVA intracommunautaire le cas échéant, e-mail de facturation, usage prévu.
  2. Notre équipe vérifie l’entreprise et l’usage, en général sous un jour ouvré, et vous prévient par e-mail.
  3. Créditez votre compte par carte, Apple Pay ou Google Pay (dès 5 € HT, facture immédiate) : voir crédit et facturation.
  4. Créez une clé vf_live_….

Étape suivante : les erreurs