Connectez vos systèmes à Marcomm AI

1. 1
   Demander l’accès

   Décrivez votre système et choisissez les données dont vous avez besoin. Nous examinons les demandes.

2. 2
   Créer une clé

   Après approbation, créez une clé dans Paramètres, API. La clé n’est affichée qu’une fois, enregistrez-la donc dans votre système.

3. 3
   Envoyer une requête

   Envoyez la clé dans l’en-tête Authorization et appelez l’un des points d’accès ci-dessous.

Exemple de requête

curl https://app.marcomm.works/api/v1/news/digest?days=7 \
  -H "Authorization: Bearer mc_live_..."

Envoyez votre clé comme jeton Bearer à chaque requête. Une clé personnelle agit au nom de la personne qui l’a créée : elle peut donc lire et trancher des validations en son nom. Une clé d’espace de travail est créée par un administrateur et ne peut que lire. Les clés peuvent expirer, être limitées à des adresses IP et être renouvelées : l’ancienne clé reste valable 24 heures après un renouvellement.

Une clé ne porte que les scopes pour lesquels votre demande a été approuvée.

news

Synthèse d’actualité, articles et médias.

crisis

Actualités critiques et incidents de crise.

approvals

Validations en attente, avec approbation ou rejet à l’aide d’une clé personnelle.

content

Lecture des communiqués de presse et des articles de blog.

Les chemins commencent par /api/v1. Les points de lecture utilisent GET et acceptent des paramètres de requête. La réponse est du JSON de la forme {"data": ...}.

Envoyez {"decision": "approve"} ou {"decision": "reject", "comment": "..."} à l’élément. Un rejet exige un commentaire. La décision suit les mêmes règles que l’application et Slack, et elle est enregistrée au nom du titulaire de la clé. Si le texte contient des formulations qui demandent confirmation, vous recevez 409 confirmation_required avec les avertissements, et vous pouvez renvoyer la requête avec "force": true.

curl -X POST https://app.marcomm.works/api/v1/approvals/press-releases/<id> \
  -H "Authorization: Bearer mc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"decision":"reject","comment":"Please fix the headline."}'

Les limites s’appliquent par espace de travail, par minute et par jour (UTC). Les réponses portent les en-têtes ci-dessous. Au-delà d’une limite, vous recevez 429 avec Retry-After. Pour relever une limite, faites une demande dans Paramètres, API. Notre équipe l’examine.

X-RateLimit-Limit

Requêtes autorisées par minute.

X-RateLimit-Remaining

Requêtes restantes dans la minute en cours.

X-RateLimit-Reset

Heure Unix de réinitialisation de la fenêtre d’une minute.

X-RateLimit-Day-Limit

Requêtes autorisées par jour.

X-RateLimit-Day-Remaining

Requêtes restantes aujourd’hui.

Retry-After

Secondes à attendre avant de réessayer. Uniquement avec 429.

Les erreurs renvoient du JSON de la forme {"error": {"code": ..., "message": ...}}.

Les alertes, les demandes de validation et le briefing du matin peuvent aussi être envoyés à votre système. Ajoutez une destination dans Paramètres, API, Webhooks. Chaque requête est du JSON avec les champs event (alert, approval ou briefing), workspace, title, text, url, data et sentAt. Une demande de validation contient data.kind (press_release, blog ou event) et data.id, que vous pouvez utiliser pour lire et trancher via l’API.

Les requêtes sont signées. Calculez le HMAC-SHA256 du corps brut de la requête avec votre secret de signature et comparez-le à l’en-tête X-Marcomm-Signature, de la forme sha256=<hex>. Rejetez les requêtes qui ne correspondent pas.

Vérifier un webhook en Node.js

import { createHmac, timingSafeEqual } from 'node:crypto';

export function isFromMarcomm(rawBody: string, signature: string, secret: string) {
  const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(signature);
  return a.length === b.length && timingSafeEqual(a, b);
}