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://api.copzen.com · Pas de clé encore ? Demandez-en une.
Les anciens chemins www.copzen.com/v1/… continuent de fonctionner : aucune intégration existante n'est à modifier.

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://api.copzen.com/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.

GET /proximite

Services de proximité autour d'une adresse ou d'un code postal : professionnels de santé, pharmacies, déchetteries, commerces. Géocodage via la Base Adresse Nationale.

Paramètres
q         adresse libre        (ex. « 14 rue Paul Bert, Lyon »)
postcode  code postal 5 chiffres

Au moins l'un des deux est requis.

Exemple — cURL
curl "https://api.copzen.com/proximite?postcode=69003" \
  -H "Authorization: Bearer $COPZEN_API_KEY"

Quota : 240 appels par heure et par clé.

Bientôt

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 ?

Laissez votre email professionnel. Nous revenons vers vous sous 24 h ouvrées avec une clé d'essai plafonnée et les conditions tarifaires — l'API est facturée à l'usage, dégressif selon le volume.

Déjà client ? Écrivez-nous via le formulaire de contact.