L'API, route par route

Une clé par site, transmise en en-tête. Aucune route n'est servie sans elle, sauf le catalogue de voix et l'échange de code, signalés comme tels.

Authorization: Bearer wd_live_xxxxxxxxxxxxxxxx

À savoir : Avec l'extension WordPress vous ne manipulerez jamais cette clé : elle s'échange de serveur à serveur. La clé en clair n'existe que pour les intégrations maison, et elle n'est jamais réaffichée après sa création.

Les messages d'erreur sont rendus en français par défaut, en anglais si vous le demandez. Le CODE HTTP, lui, ne change jamais : c'est sur lui qu'il faut brancher votre logique, pas sur le texte.

Accept-Language: en

À savoir : Deux routes ne traduisent pas encore leurs messages, dont les recommandations. Traitez le code, pas la phrase.

Dix générations par minute, quatre lots par minute, trente aperçus de voix par heure. Les quatorze autres routes n'ont pas de limite de débit. Un dépassement rend un 429.

429 { "error": "…maximum 10 générations par minute…" }

À savoir : Deux de ces trois compteurs vivent en mémoire d'instance : ce sont des garde-fous, pas des garanties contractuelles. Seule la limite de génération est comptée en base.

Dix codes couvrent tout ce que l'API peut refuser. Branchez votre logique dessus, jamais sur le texte du message.

400 requête mal formée, champ absent ou hors bornes
401 clé absente, inconnue ou révoquée
402 la retouche dépasse le budget inclus et n'a pas été confirmée
403 le compte est bloqué, ou la capacité n'est pas ouverte
404 la ressource visée n'existe pas, ou n'est pas la vôtre
409 l'état actuel interdit l'opération demandée
429 une limite de débit ou le volume mensuel est atteint
500 un défaut de notre côté, à signaler
502 un service dont nous dépendons a répondu de travers
503 indisponibilité temporaire, réessayez plus tard

À savoir : UN 409 N'EST PAS UNE ERREUR DE VOTRE CÔTÉ : il dit que l'ordre des opérations ne va pas, une régénération déjà en cours, un audio produit avant le calage mot à mot. Le rejouer à l'identique plus tard marche souvent. Un 400 rejoué à l'identique, jamais.

La route principale. Avec `wait` à vrai, la réponse attend la fin de la synthèse et contient l'adresse du fichier : l'article se publie déjà sonorisé, sans délai visible.

Idempotency-Key Rejouer le même appel avec la même clé ne produit pas un second audio.

POST https://wedispatch.fr/api/v1/podcasts
Content-Type: application/json

{
  "text": "Le conseil municipal a adopte hier soir...",
  "title": "Le budget 2027 adopte",
  "external_id": "id-dans-votre-cms",
  "rubrique": "Politique",
  "wait": true
}

Ce qu'elle renvoie : `article_id`, `job_id`, `status`, `embed`, et avec `wait` : `audio_url`, `duration_s`, `version`, `engine`, `voice`, `fallback`.

À traiter : 400 texte, voix, langue ou date invalides · 403 compte bloqué · 429 quota mensuel atteint, ou dix par minute dépassé

À savoir : Un article de plus de 1 000 caractères consomme un crédit de plus par tranche entamée, et la tranche entamée est perdue.

Jusqu'à vingt-cinq articles en une requête, pratique pour un fonds d'archives. Chaque champ unitaire est accepté par entrée, et `language`, `trigger` et `auto_regenerate` acceptent aussi une valeur pour tout le lot.

POST https://wedispatch.fr/api/v1/podcasts/batch
{ "items": [
  { "text": "...", "external_id": "a1", "rubrique": "Sports" },
  { "text": "...", "canonical_url": "https://.../article-2" }
] }

Ce qu'elle renvoie : `accepted`, `total`, et `results[]` où chaque entrée porte son propre `status` : `processing`, `ready`, `stale`, `quota`, `blocked`, `skipped` ou `error`.

À traiter : 400 items absent, vide ou au-delà de vingt-cinq · 429 quatre lots par minute dépassé

À savoir : `wait` n'existe PAS sur cette route, et l'en-tête d'idempotence n'y est pas lu. Le volume mensuel restant borne le lot avant les limites de débit : vingt-cinq articles avec dix crédits restants en traite dix et signale le reste en `quota`.

Pour un article modifié en profondeur. Consomme un crédit comme une génération. Elle repart aussi d'un compteur de correction vierge (`patch_chars_used`), qui n'est qu'une mesure du texte repris sur cet audio : il n'ouvre aucun droit, et une correction coûte le même prix avant et après.

POST https://wedispatch.fr/api/v1/podcasts/{article_id}/regenerate

Ce qu'elle renvoie : `article_id`, `job_id`, `status`, `regens_included`, `regens_used`.

À traiter : 404 article inconnu · 409 aucun texte stocké à régénérer · 429 plafond de régénérations ou quota mensuel

À savoir : C'est la première cause de consommation involontaire, en général après une petite correction de texte. Regardez d'abord si la retouche suffit : elle ne facture que le passage réécrit, là où une régénération repaie l'article entier.

Compare le dernier texte envoyé par `POST /podcasts` à celui de l'audio et ne relit que les phrases modifiées, recousues dans l'audio existant. Envoyez d'abord le nouveau texte : la page n'est pas relue. Sans `accept`, la route étudie et donne le prix sans rien dépenser ; avec `accept: true`, elle relit. Le prix est celui d'une retouche : les caractères relus, au prorata.

POST https://wedispatch.fr/api/v1/podcasts/{article_id}/partial

Ce qu'elle renvoie : Étude : `possible`, `reason` (quand ce n'est pas possible : `inchange`, `trop`, `alignement`, `texte-choisi`, `sans-horodatage`, `retouche-non-incluse`…), `message`, `passages_count`, `passages` (`before`, `after`, cinq au plus), `chars`, `credits`, `credits_full_regeneration`. Relecture : `ok`, `version`, `duration_s`, `status`, `passages_count`, `credits_used`.

À traiter : 402 accord manquant · 403 retouche hors forfait · 404 article inconnu · 409 relecture impossible ou prix dépassé · 502 synthèse ou fichier en échec, rien de décompté

À savoir : Au-delà d'un tiers du texte changé, ou quand les changements ne se situent pas avec certitude dans l'audio, la route répond `possible: false` : régénérez alors entièrement.

L'état d'un article et, quand il est prêt, l'adresse de son audio. À appeler après un envoi sans `wait`, ou à la réception d'un webhook.

GET https://wedispatch.fr/api/v1/podcasts/{article_id}

Ce qu'elle renvoie : `article_id`, `title`, `status` (`processing`, `ready`, `stale` ou `failed`), `regen_count`, `summary`, `audio` (`null` ou l'objet complet avec `url`, `duration_s`, `version`, ses `chapters` quand l'article en porte et `midroll_s` quand une frontière de paragraphe a été trouvée), `embed`, `subtitles`.

À traiter : 404 article inconnu · 503 lien audio temporairement indisponible

Les trente derniers articles du compte, du plus récemment modifié au plus ancien.

GET https://wedispatch.fr/api/v1/podcasts

Ce qu'elle renvoie : `articles[]` : `id`, `title`, `canonical_url`, `audio_status`, `char_count`, `regen_count`, `updated_at`, et selon l'état de la base `rubrique` et `author`.

À savoir : CETTE ROUTE N'ACCEPTE AUCUN PARAMÈTRE. Ni filtre d'état, ni pagination, ni date. Trente lignes, toujours. Si vous avez besoin de retrouver les articles à régénérer, comparez vous-même `audio_status` sur ce que vous recevez.

Supprime les fichiers audio d'un article. L'article, son texte source et ses statistiques d'écoute sont conservés.

DELETE https://wedispatch.fr/api/v1/podcasts/{article_id}

Ce qu'elle renvoie : `ok`, `article_id`, `status`, `removed_versions`, et `kept` qui dit explicitement ce qui n'a pas été supprimé.

À traiter : 400 identifiant invalide · 404 article inconnu · 409 une génération est en cours

À savoir : Aucun crédit n'est remboursé, et la réponse le dit plutôt que de le taire.

Les articles les plus proches d'un article donné, pour proposer une écoute suivante.

GET https://wedispatch.fr/api/v1/recommendations?article_id={uuid}&limit=5

Ce qu'elle renvoie : `article_id`, `count`, `recommendations[]` avec `id`, `title`, `rubrique`, `created_at`, `player_url`.

À traiter : 400 article_id absent ou mal formé · 404 article introuvable

Le lecteur se pose en une ligne. Le mode automatique retrouve seul l'audio correspondant à la page affichée, à partir de son adresse canonique.

<script src="https://wedispatch.fr/player.js" data-article="{article_id}" defer></script>

<!-- ou une seule fois pour tout le site : l'audio est retrouvé depuis l'adresse de la page -->
<script src="https://wedispatch.fr/player.js" data-site="{client_id}" defer></script>

À savoir : Si votre thème filtre le contenu par un point d'entrée inhabituel, l'insertion automatique peut échouer. Un conteneur `<div data-wedispatch>` posé où vous voulez vous rend la main sur l'emplacement exact.

Certaines rédactions n'assemblent pas leurs pages avec du JavaScript : elles les composent côté serveur à partir de blocs fournis par des services externes, et leur règle interdit l'iframe. WeDispatch est fournisseur de bloc. Vous déclarez le nôtre, vous le posez dans un gabarit, et c'est votre moteur qui produit le HTML.

GET https://wedispatch.fr/api/blocs/contrat
GET https://wedispatch.fr/api/blocs/lecteur?article={article_id}
GET https://wedispatch.fr/api/blocs/lecteur?externe={votre_id}&site={client_id}

# les deux fichiers que le contrat declare, servis par nous, versionnes avec lui
https://wedispatch.fr/sdk/wedispatch-bloc.js
https://wedispatch.fr/sdk/bloc-texte.css

Ce qu'elle renvoie : Le contrat déclare deux blocs, le lecteur et le texte synchronisé, avec leur gabarit, leurs paramètres et leur politique de cache. Le point de données rend `{ internal: { data } }` : titre, adresse audio, durée, chapitres, résumé et adresse du calage mot à mot.

À savoir : LE GABARIT EST LE VÔTRE, PAS LE NÔTRE : nous ne déclarons aucune feuille de style pour le lecteur, le balisage s'appuie sur les composants de votre système de design. Le contrat se lit sans clé, pour que votre outil de validation le vérifie sans nous. Un compte sous embargo n'est pas servi par cette voie : sans jeton de visiteur, une adresse signée rendue à un serveur tiers serait une porte dérobée.

Si vous voulez votre propre lecteur sans le réécrire : un composant web isolé, la même logique sans interface pour poser votre rendu, un adaptateur qui pilote un lecteur déjà présent dans votre système de design, et deux implémentations de référence, iOS et Android. Vous copiez les fichiers, vous les versionnez avec les vôtres.

<!-- les fichiers, à recopier chez vous -->
https://wedispatch.fr/sdk/wedispatch-player.js     le composant web
https://wedispatch.fr/sdk/reference-web.js         la logique, sans interface
https://wedispatch.fr/sdk/wedispatch-sipaui.js     l'adaptateur d'un lecteur existant
https://wedispatch.fr/sdk/reference-ios.swift
https://wedispatch.fr/sdk/reference-android.kt
https://wedispatch.fr/sdk/LISEZMOI.md              le mode d'emploi

Ce qu'elle renvoie : Lecture, surlignage mot à mot, chapitres, reprise à la position quittée, confort de lecture, barre collante, accessibilité au clavier et jalons d'écoute. Aucun fichier ne porte de clé ni n'appelle cette API : votre serveur fabrique un manifeste depuis `GET /podcasts/{id}` et `GET …/words`.

À savoir : CES FICHIERS NE SE METTENT PAS À JOUR TOUT SEULS, c'est le prix de l'indépendance : un correctif de notre côté n'arrive chez vous que quand vous reprenez le fichier. Les changements sont annoncés dans le journal des versions. Deux fichiers du dossier `/sdk` ne font PAS partie de la boîte et ne se copient pas, `wedispatch-bloc.js` et `bloc-texte.css` : ils sont servis pour le bloc de composition serveur et versionnés avec son contrat.

Fichier de sous-titres aligné sur la lecture RÉELLE, pas sur le texte source. C'est ce qui évite la dérive dès le premier nombre développé.

GET https://wedispatch.fr/api/v1/podcasts/{article_id}/subtitles?format=vtt

Ce qu'elle renvoie : Le fichier lui-même, en texte brut. Ce n'est pas du JSON.

À traiter : 400 format inconnu · 404 article ou calage introuvable · 409 audio produit avant le calage mot à mot

Les articles sonorisés des dernières vingt-quatre heures, dans l'ordre de lecture, avec leur durée et leur résumé. C'est la matinale, en JSON : de quoi construire une liste de lecture sans passer par notre iframe.

GET https://wedispatch.fr/api/v1/selection?rubrique=Sports&limit=10

Ce qu'elle renvoie : `mode` (`day` si la fenêtre du jour a donné quelque chose, `latest` sinon), `window_h`, `rubrique`, `count`, `total_duration_s`, `generated_at`, et `items[]` avec pour chaque piste `article_id`, `title`, `summary`, `duration_s`, `published_at`, `audio`, ses `chapters` quand il y en a, `embed` et `subtitles`.

À savoir : UNE VALEUR HORS BORNES EST RAMENÉE DANS LES BORNES, jamais refusée. Un site qui n'a rien publié depuis la veille reçoit ses cinq derniers articles avec `mode: latest` : lisez ce champ avant d'écrire « La matinale » au-dessus de la liste. La route rend les fichiers complets, signés si le compte protège ses fichiers : c'est votre serveur qui décide ensuite ce qu'il donne à chaque visiteur.

Où cette phrase est-elle dite ? La réponse est l'instant exact et l'extrait autour. De quoi construire un lien qui démarre à la bonne seconde, ou une recherche interne qui pointe vers un passage plutôt que vers un article.

GET https://wedispatch.fr/api/v1/podcasts/{article_id}/search?q=la%20piscine

Ce qu'elle renvoie : `article_id`, `title`, `query`, `duration_s`, `count`, et `results[]` avec pour chaque occurrence `t`, la seconde exacte, et `excerpt`, six mots de chaque côté.

À traiter : 400 paramètre q absent ou identifiant invalide · 404 article inconnu · 409 aucun audio publié · 409 audio produit avant le calage mot à mot

À savoir : LA RECHERCHE EST STRICTE : une séquence exacte de mots, sans correction orthographique ni approximation. Un résultat faux coûte plus cher que pas de résultat, puisqu'il ferait écouter le mauvais passage. Vingt occurrences au plus, et dans UN article : chercher dans tout un fonds demanderait un index, qui n'existe pas.

Le premier des deux temps d'une retouche : un passage se désigne par des index de mots, il faut donc d'abord savoir où chaque mot tombe dans la bande son.

GET https://wedispatch.fr/api/v1/podcasts/{article_id}/words

Ce qu'elle renvoie : `article_id`, `title`, `duration_s`, `words[]` avec pour chaque mot son début et sa fin, et `chapters[]` quand l'article en porte : le même fichier annexe les contient, les rendre ici évite un second appel à qui fabrique un lecteur.

À traiter : 403 la retouche n'est pas ouverte sur ce compte · 409 le moteur utilisé ne produit pas de calage mot à mot · 409 audio antérieur au calage

Vous réécrivez le passage fautif, lui seul est resynthétisé et recousu dans l'audio existant. L'adresse du fichier ne change pas, donc vos pages n'ont rien à mettre à jour.

POST https://wedispatch.fr/api/v1/podcasts/{article_id}/correct
{
  "from_word": 142,
  "to_word": 149,
  "text": "deux virgule quatre millions d'euros"
}

Ce qu'elle renvoie : `ok`, `version`, `duration_s`, `patch_chars`, `patch_chars_used`, `credits_used`, `review`.

À traiter : 402 la dépense n'a pas été confirmée · 403 la retouche n'est pas ouverte sur ce compte · 409 audio sans calage mot à mot

À savoir : Le prix est rendu SUR LE REFUS, dans `credits_required` : c'est au moment où l'on est refusé qu'on a besoin de savoir ce que la demande coûterait. Une retouche se paie au prorata de ce qu'elle réécrit (mille caractères font un crédit, `credits_required` peut donc valoir 0,02) ; il n'existe pas de retouche à zéro crédit. `review` à vrai signale une couture serrée qui mérite une écoute avant diffusion.

Tous les réglages du compte, groupés par domaine, plus ce que votre offre ouvre réellement.

GET https://wedispatch.fr/api/v1/profile

Ce qu'elle renvoie : `player`, `reading` (dont le lexique de prononciation), `sound`, `editorial`, `gate`, `capabilities`, `player_templates`, et `editable` : la liste exacte des champs qu'une clé peut écrire.

À savoir : `editable` est la source de vérité. Plutôt que de recopier la liste ci-dessous dans votre code, lisez-la : elle vous dira ce qui est modifiable le jour où elle changera. LISEZ AUSSI `editorial.summary_effective` : le mode charte éteint le résumé même quand il est activé, et c'est le seul champ qui répond « oui ou non » à la question qui compte. `editorial` est en lecture seule, ce sont des engagements et non des préférences d'affichage.

Les corrections de prononciation du compte, celles qui s'appliquent à tous les articles avant synthèse.

GET https://wedispatch.fr/api/v1/pronunciations

Ce qu'elle renvoie : `pronunciations` (la liste `{ de, vers }`), `count`, `max`.

À savoir : La LECTURE n'est pas réservée : un compte qui perd l'option doit pouvoir relire et exporter ce qu'il avait posé. C'est l'écriture qui l'est.

Fusionne dans le lexique existant : ce que vous n'envoyez pas n'est pas touché. Un mot déjà présent voit sa prononciation remplacée, jamais dupliquée.

POST https://wedispatch.fr/api/v1/pronunciations
{ "de": "Ploërmel", "vers": "Plo-air-mel" }

Ce qu'elle renvoie : La liste complète après le geste, plus `added`, `replaced`, `ignored`.

À traiter : 400 aucune entrée exploitable (`de` et `vers` requis, 80 caractères au plus) · 403 le lexique n'est pas ouvert sur ce compte · 409 lexique plein (200 entrées)

À savoir : Un appel qui n'a RIEN posé rend une erreur, jamais un 200 : sans quoi votre interface afficherait « enregistré » pour une correction qui n'existe pas. La casse ne crée pas de doublon, les accents si : « Ploërmel » et « Ploermel » sont deux entrées, et c'est voulu.

Par mot source, casse ignorée. Retirer un mot absent n'est pas une erreur.

DELETE https://wedispatch.fr/api/v1/pronunciations
{ "de": "Ploërmel" }

Ce qu'elle renvoie : La liste complète après le geste, plus `removed`.

À traiter : 400 ni `de`, ni `pronunciations`, ni `all: true`

À savoir : Tout vider EXIGE `all: true`. Un DELETE sans corps est ce qu'un client HTTP envoie quand il se trompe d'appel ; lui faire effacer deux cents entrées irrécupérables serait un piège.

Vingt-cinq champs sont modifiables par clé, dont le lexique de prononciation, la voix par défaut, les règles de voix et l'apparence du lecteur.

PUT https://wedispatch.fr/api/v1/profile
{ "default_voice": "...", "player_template": "..." }

Ce qu'elle renvoie : `ok`, plus `ignored[]` si vous avez envoyé des champs qui ne sont pas modifiables par clé.

À traiter : 400 aucun champ modifiable dans le corps envoyé · 403 le réglage demandé n'est pas ouvert sur ce compte · 409 le réglage exige un calage mot à mot absent

À savoir : Un champ non modifiable n'est pas une erreur : il est écarté et RENDU dans `ignored`, pour que vous le voyiez au lieu de le supposer appliqué. Le mode d'accès conditionnel n'est jamais modifiable par clé, délibérément.

Le volume souscrit, la consommation de la période de crédits, et ce que l'offre inclut.

GET https://wedispatch.fr/api/v1/account

Ce qu'elle renvoie : `plan_label`, `volume`, `usage` (dont `credits_used`, `credits_quota`, `articles_left`, `period_start`, `period_end`, `resets_at`, `counted_since`), `included`, `access`, `offre`, `urls`.

À savoir : `plans` et `next_plan` sont vides et le resteront : ils datent des anciens forfaits et ne sont gardés que pour ne casser aucune intégration existante. La structure de `offre` n'est pas décrite ici, faute d'avoir été auditée : lisez-la plutôt que de la supposer.

Ce qui a été consommé sur la période de crédits en cours, en crédits et en caractères. Pour un volume payant, la période va d'un anniversaire de l'abonnement au suivant : `period_end` est l'instant où le volume repart.

GET https://wedispatch.fr/api/v1/usage

Ce qu'elle renvoie : `period`, `quota_credits`, `credits_used`, `credits_left`, `period_start`, `period_end`, `period_source`, `counted_since`, `percent_used`, `warning`, `blocked`, `generations`, `regenerations`, `listens`, `audio_minutes`.

Des comptages agrégés, par article, par rubrique et par signature. Jamais par personne : l'information n'existe pas.

GET https://wedispatch.fr/api/v1/stats

Ce qu'elle renvoie : `generated_at`, `totals`, `last_30_days`, `articles`, `authors`.

À savoir : Aucun paramètre : pas de filtre de période, pas de pagination. La structure interne des agrégats n'est pas détaillée ici faute d'audit : elle est stable, mais nous préférons vous la faire lire que vous la décrire de mémoire.

Un retour court, envoyé par l'extension WordPress au moment où quelqu'un la désactive, et UNIQUEMENT s'il a cliqué « Envoyer ». Documentée ici parce qu'elle existe : une route qu'on n'écrit pas est une route qu'on oublie de sécuriser.

POST https://wedispatch.fr/api/v1/feedback
{ "type": "desactivation", "motif": "affichage", "texte": "…", "version": "1.27.0" }

Ce qu'elle renvoie : `ok`. Toujours 200 : l'appelant est en train de désactiver une extension, son geste ne doit dépendre d'aucune de nos pannes.

À savoir : Ne contient jamais de contenu d'article ni rien sur un auditeur. Les champs inconnus sont ignorés sans erreur, pour qu'une version future de l'extension ne perde pas son retour sur un détail de forme.

Les voix disponibles pour votre compte, y compris vos voix signature.

GET https://wedispatch.fr/api/v1/voices

Ce qu'elle renvoie : `engine`, `default`, `voices[]` avec `id`, `label`, `gender`, `style`, `langs[]`, et `sample` quand un extrait existe.

À savoir : Cette route est servie SANS clé, parce que la documentation et le démonstrateur en dépendent. En revanche, une clé PRÉSENTÉE et refusée fait échouer l'appel : elle ne retombe jamais sur le catalogue public, ce qui masquerait une clé morte.

Un extrait sonore sur votre propre texte, avant de choisir. Ne consomme aucun crédit.

POST https://wedispatch.fr/api/v1/voices/preview
{ "text": "...", "voice": "..." }

Ce qu'elle renvoie : Le fichier audio lui-même. L'en-tête `X-WeDispatch-Billed` vaut zéro, et l'en-tête `X-WeDispatch-Voice` dit quelle voix a réellement parlé.

À traiter : 400 texte trop court ou trop long · 429 trente aperçus par heure dépassés

À savoir : Une voix inconnue n'est PAS refusée ici : elle est remplacée par la voix par défaut. Lisez l'en-tête de réponse pour savoir laquelle a servi, sans quoi vous croirez avoir écouté celle que vous aviez demandée.

Ce que fait l'extension WordPress sur un site pas encore connecté, quand un administrateur clique pour entendre son dernier article. Sans clé : c'est précisément la personne qui n'en a pas encore.

POST https://wedispatch.fr/api/v1/extrait
{ "texte": "...", "langue": "fr", "site": "https://exemple.fr/" }

Ce qu'elle renvoie : Le fichier MP3 lui-même.

À traiter : 400 texte trop court · 415 corps autre que JSON · 429 quatre extraits par heure dépassés · 503 plafond du jour atteint · 502 la voix n'a pas pu être produite

À savoir : Le texte n'est pas conservé. La route est bornée par un plafond journalier commun à tous les essais sans compte, qui refuse s'il ne peut pas se lire : pour un usage régulier, connectez le site.

Le mode d'accès du compte et le secret qui permet de signer des jetons d'écoute.

GET https://wedispatch.fr/api/v1/access

Ce qu'elle renvoie : `mode`, `preview_seconds`, `token_ttl_s`, `secret`, `client_id`.

À savoir : Le secret ne sort jamais du serveur. Cette route est à appeler depuis votre back-office, jamais depuis une page.

Pour un contenu réservé : votre serveur vérifie qu'un jeton donne bien droit à cet article.

POST https://wedispatch.fr/api/v1/access/check
{ "article": "{article_id}", "token": "..." }

Ce qu'elle renvoie : `valid`, `status`, `reason`, `detail`, `mode`. Le motif dit précisément pourquoi : jeton absent, mal formé, signature invalide, mauvais article, ou expiré.

À traiter : 400 champ article manquant

Ce que fait l'extension WordPress à l'installation : elle échange un code à durée courte contre sa propre clé, de serveur à serveur. L'utilisateur ne voit jamais la clé.

POST https://wedispatch.fr/api/v1/connect/exchange
{ "code": "...", "secret": "..." }

Ce qu'elle renvoie : `api_key`, `plan`, `tier`, `site`, `label`.

À traiter : 400 code expiré ou invalide · 400 maximum dix clés actives atteint · 404 compte introuvable

À savoir : Avec le catalogue de voix et l'extrait d'essai, c'est l'une des rares routes qui ne demandent pas de clé : elle sert justement à en obtenir une.