COPZEN — Documentation API (développeurs)

Authentification

Toutes les requêtes nécessitent votre clé partenaire dans l'en-tête HTTP. Les clés sont strictement confidentielles (stockées hashées chez nous) et s'utilisent depuis votre backend (jamais côté navigateur).

En-tête
Authorization: Bearer cz_live_xxxxxxxxxxxxxxxxxxxxxxxx

Base URL : https://www.copzen.com · Pas de clé encore ? Demandez-en une.

POST /v1/decrypt

Décrypte un document de copropriété. Fournissez text (recommandé) ou document_base64 (PDF).

Corps de la requête

Champ	Type	Détail
`text`	string	Texte du document (ou `document_base64`)
`document_base64`	string	PDF encodé en base64 (alternative à `text`)
`doc_type`	string	Optionnel : `pv` (défaut) · `devis` · `appel_de_fonds`
`model`	string	Optionnel : `anthropic/claude-opus-4.8` · `claude-sonnet-4.6` · `claude-haiku-4.5`

Exemple — cURL

curl -X POST https://www.copzen.com/v1/decrypt \
  -H "Authorization: Bearer $COPZEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"doc_type":"pv","text":"Procès-verbal de l assemblée générale du 12 mars 2026..."}'

Réponse 200

{
  "ok": true,
  "data": {
    "titre": "AG ordinaire du 12 mars 2026",
    "resume": "...",
    "decisions": [ ... ],
    "montants":  [ ... ],
    "echeances": [ ... ],
    "vigilance": [ ... ]
  },
  "usage": { "model": "...", "input_tokens": 1509, "output_tokens": 711 },
  "partner": "Votre cabinet"
}

Erreurs & limites

Code	Signification
`401 unauthorized`	Clé manquante ou invalide
`429 rate_limited`	Quota dépassé — 120 requêtes / heure / clé
`400 missing_input` / `input_too_short` / `pdf_unsupported`	Entrée absente, trop courte (PDF scanné ?), ou PDF non supporté → fournir `text`
`413 input_too_large`	Document trop volumineux
`422 not_analyzable`	Document non analysable
`500 internal_error`	Erreur interne

Format d'erreur : { "error": { "code": "...", "message": "..." } }. Chaque appel réussi est compté pour la facturation à l'usage.

Bientôt

GET /v1/proximite (services autour d'un immeuble) · POST /v1/signalement · GET /v1/artisans. Données hébergées en Union européenne · conformité RGPD · DPA de sous-traitance fourni.

Prêt à intégrer ?

Obtenez une clé API et un accès de test pour votre logiciel ou votre parc.