Référence API

Cette page couvre l’API REST côté serveur utilisée pour uploader ton catalogue et ton contenu. Pour l’intégration frontend, voir la Référence SDK et les docs composants React / Vue.

Authentification

Ajoute ta clé API privée Dialog dans le header Authorization sur chaque requête.

Authorization: MY_PRIVATE_KEY

Ta clé privée est visible dans le dashboard Dialog après création d’une organisation API Integration. Garde-la côté serveur — elle ne doit pas être shippée dans le navigateur.

Upload URLs

Dialog utilise des URLs S3 pré-signées pour les uploads catalogue et contenu.

Récupérer les upload URLs

POST https://rtbzcxkmwj.execute-api.eu-west-1.amazonaws.com/organization/catalog-upload-url

Réponse :

{
  "catalogUploadUrl": {
    "url": "your-upload-url",
    "fields": {
      "bucket": "dialog-bucket-name",
      "X-Amz-Algorithm": "",
      "key": "fileKey",
      "Policy": "",
      "X-Amz-Credential": "",
      "X-Amz-Date": "",
      "X-Amz-Signature": "",
      "X-Amz-Security-Token": ""
    }
  },
  "pageUploadUrl": { /* même format */ },
  "blogPostUploadUrl": { /* même format */ }
}

Pour chaque fichier, utilise l’URL et les fields pour uploader vers le bucket S3 de Dialog. Voir AWS S3 pre-signed URL docs pour le flow complet.

Uploads

Upload catalogue

Uploade un fichier JSON qui respecte le schéma catalogue. Voir Schéma du catalogue pour le JSON Schema complet.

Upload blog

Si ton site a un blog, uploade un array de { title, content } :

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "title": { "type": "string" },
      "content": { "type": "string" }
    },
    "required": ["title", "content"]
  }
}

Upload pages

Pour les FAQ, infos livraison et autres pages statiques, uploade un array de { title, content } (même schéma que le blog).

Troubleshooting

Status	Cause probable	Solution
401	Header d’auth manquant	Ajouter `Authorization: YOUR_KEY`
403	Clé invalide ou expirée	Régénérer la clé dans le dashboard
400	Payload non conforme	Valider contre le schéma
500	Erreur serveur	Écrire au support avec l’ID de requête

Suite

Schéma du catalogue — format JSON exact de l’upload catalogue.
Référence SDK — intégration frontend.