{"service":"api.mpproduction.fr","version":"1.1.0","description":"Passerelle de génération de contenu et d'envoi de courrier postal, facturée à l'usage.","services":{"article":"Rédaction d'un article de blog original à partir d'un titre et d'un résumé.","image":"Génération d'une illustration à partir d'une description.","courrier":"Impression et envoi d'un courrier postal papier, avec suivi d'acheminement.","sms":"Envoi de SMS, facturé au segment et par destinataire."},"authentification":{"schema":"Authorization: Bearer mpp_live_…","domaine":"X-MPP-Domain, obligatoire : le domaine d'où vous appelez.","idempotence":"X-MPP-Request-Id, obligatoire sur les POST : un UUID v4 neuf à chaque appel. Rejouer le même identifiant renvoie la réponse d'origine au lieu de refacturer.","obtenir_une_cle":"https://mpproduction.fr — une seule clé ouvre les trois services."},"endpoints":[{"methode":"GET","chemin":"/","authentifie":false,"role":"Cette page."},{"methode":"GET","chemin":"/v1/ping","authentifie":true,"role":"Vérifie la clé et le domaine."},{"methode":"GET","chemin":"/v1/account","authentifie":true,"role":"Vos tarifs, votre plafond, votre consommation du mois."},{"methode":"POST","chemin":"/v1/generate/article","authentifie":true,"role":"Rédige un article. Facturé."},{"methode":"POST","chemin":"/v1/generate/image","authentifie":true,"role":"Génère une image. Facturé."},{"methode":"POST","chemin":"/v1/courrier","authentifie":true,"role":"Envoie un courrier. Facturé en mode live uniquement."},{"methode":"GET","chemin":"/v1/courrier/{id}","authentifie":true,"role":"État et acheminement d'un pli."},{"methode":"POST","chemin":"/v1/sms","authentifie":true,"role":"Envoie un SMS. Facturé en mode live uniquement."},{"methode":"GET","chemin":"/v1/sms/{id}","authentifie":true,"role":"Détail d'un envoi de SMS."}],"courrier":{"modes":{"test":"Produit un PDF d'aperçu. Rien n'est posté, rien n'est facturé.","live":"Le pli est imprimé, posté et facturé. Doit être autorisé sur votre clé."},"mode_par_defaut":"test","affranchissements":["ecopli","prioritaire","lr","lrar"],"couleurs":["bw","color"],"enveloppes":["c6","c4"],"contenu_accepte":["html","url","modele_id","pdf_base64"],"statuts":["cree","accepte","envoye","distribue","adresse_invalide"],"note_prix":"Le prix d'un pli dépend du nombre de pages rendu : il n'est donc pas connu avant l'appel. La réponse le renvoie, et /v1/account en donne des exemples chiffrés."},"sms":{"modes":{"test":"Découpe le message et chiffre l'envoi sans appeler l'opérateur. Rien n'est émis, rien n'est débité.","live":"Le SMS part réellement et est facturé. Doit être autorisé sur votre clé."},"mode_par_defaut":"test","destinataires_max":200,"longueur_max":1530,"format_numero":"International (+33612345678) ou national (0612345678).","note_segmentation":"La facturation se fait au segment : 160 caractères pour un SMS classique, mais 70 seulement dès qu'un caractère sort de l'alphabet GSM — un emoji, un « œ » ou une apostrophe typographique suffit à plus que doubler le coût. Le mode test le chiffre à l'avance.","clause_stop":"Ajoutée d'office : elle est obligatoire sur tout SMS publicitaire en France."},"erreurs":{"forme":"{\"erreur\":{\"code\":\"…\",\"message\":\"…\"}}","note":"Affichez erreur.message. Une erreur 502 n'est jamais facturée : le fournisseur a échoué, vous n'avez rien reçu."},"tarifs":"Propres à chaque client. Appelez /v1/account avec votre clé."}