---
title: "Lecture de l’Observatoire, sans compte ni crédit : passages à relire, leur critère et leur position (ni détecteur d’IA, ni preuve d’auteur)"
method: POST
path: "/api/v1/observatory/signals"
tags: ["Mesure"]
---

# Lecture de l’Observatoire, sans compte ni crédit : passages à relire, leur critère et leur position (ni détecteur d’IA, ni preuve d’auteur)

`POST /api/v1/observatory/signals`

## Request

- Base URL: `https://kaneme.com`
- URL: `https://kaneme.com/api/v1/observatory/signals`
- Auth: none required

## Request body

- object
  - `text` string, required: Texte à lire (12000 caractères au plus).
  - `language` 'fr' | 'en': Langue du texte. Absente, elle est détectée ; indéterminée, la lecture la demande.
  - `documentType` 'general' | 'social' | 'article' | 'email' | 'report' | 'marketing' | 'documentation': Type de texte, qui règle les conseils (défaut : general).

## Response `200`

Succès.

- ObservatorySignals
  - `source` 'observatoire', required
  - `methodVersion` string, required
  - `analyzerSha256` string, required
  - `language` 'fr' | 'en', required
  - `languageSource` 'request' | 'detected', required
  - `documentType` 'general' | 'social' | 'article' | 'email' | 'report' | 'marketing' | 'documentation', required
  - `words` integer, required
  - `sentences` integer, required
  - `positions` 'utf16', required
  - `textNormalized` boolean, required
  - `counts` object, required
  - `findings` object[], required
    - `criterion` string, required
    - `category` string, required
    - `label` string, required
    - `start` integer, required
    - `end` integer, required
    - `quote` string, required
    - `explanation` string, required
    - `action` string, required
    - `example` string, nullable, required
    - `quoted` boolean, required
  - `notice` string, required

## Other responses

- `400`: Requête invalide (champ manquant, borne dépassée, curseur illisible).
- `404`: Ressource introuvable.
- `429`: Cadence dépassée (code « rate_limited »). La réponse porte X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Window et Retry-After — attends la fenêtre indiquée : un retry immédiat la prolonge. Les plafonds appliqués sont dans x-kaneme-rate-limits. Quand le refus vient d’un plafond PAR OPÉRATION (générer, créer un document ou un projet, déposer une source), ces nombres sont ceux de CETTE opération, pas ceux de la surface.
- `500`: Erreur interne.

---

[API](https://skmtc.dev/kaneme/apis/kaneme-api.md) · [All operations](https://skmtc.dev/kaneme/apis/kaneme-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaneme/apis/kaneme-api/revisions/752895651cd0?raw)