**Versions de l’API** · [V2 (Latest)](/integrations/v2/docs?lang=fr) · **V1**

> **Cette version de l’API est obsolète.** Utilisez la dernière version pour toute nouvelle intégration. [Voir la documentation actuelle](/integrations/v2/docs?lang=fr)

# Blocs de contenu

OpenAPI 3.0.3 · API 1.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v1",
    "description": "API"
  }
]
```

Blocs de contenu IA réutilisables — fragments HTML autonomes affichés partout où leur identifiant est référencé (par ex. page d’accueil touristique via `homepage.aiContentBlockId` dans la configuration Travel, ou introduction d’un groupe d’événements à sessions multiples). Envoyez du HTML BRUT ; le serveur ajoute les clés data-i18n (voir les règles de rédaction HTML de ContentBlockContentInput). Autorisations : `content_blocks:read`/`content_blocks:write`.

## Opérations

## GET /content-blocks

Lister les blocs de contenu

`list_content_blocks`

Autorisation requise : `content_blocks:read`. Liste les blocs de contenu de l’organisation (champs succincts). Résultats paginés. Pour savoir QUEL bloc alimente un emplacement, consultez la configuration qui le référence — par ex. `homepage.aiContentBlockId` de Travel.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "content_blocks:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContentBlock"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /content-blocks/{id}

Obtenir un bloc de contenu

`get_content_block`

Autorisation requise : `content_blocks:read`. Bloc complet, avec `html`, `i18n` et `mainLang`.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "content_blocks:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/ContentBlock"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PUT /content-blocks/{id}/content

Définir le contenu HTML d’un bloc

`set_content_block_content`

Autorisation requise : `content_blocks:write`. Définit le HTML du bloc ; le serveur injecte les clés data-i18n et fusionne les traductions (voir les règles de rédaction HTML obligatoires de ContentBlockContentInput). Upsert : si l’identifiant n’existe pas, le bloc est créé. Vous pouvez donc écrire un bloc, puis le lier à la page d’accueil Travel (`PATCH /travel/{travelId}/config/homepage` avec `aiContentBlockId`) ou à un groupe d’événements.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "content_blocks:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContentBlockContentInput"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /content-blocks/{id}/translations

Définir les traductions d’un bloc de contenu

`set_content_block_translations`

Autorisation requise : `content_blocks:write`. Met à jour, pour une langue, les traductions des clés data-i18n existantes. Ne modifie pas le HTML.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "content_blocks:write",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContentBlockTranslationsInput"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "parameters": {
      "LimitParam": {
        "name": "limit",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200,
          "default": 50
        },
        "description": "Nombre de résultats par page."
      },
      "CursorParam": {
        "name": "cursor",
        "in": "query",
        "schema": {
          "type": "string"
        },
        "description": "Curseur opaque renvoyé par la requête précédente."
      },
      "ContentBlockIdParam": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
      }
    },
    "schemas": {
      "ContentBlock": {
        "type": "object",
        "description": "Bloc de contenu IA réutilisable : fragment HTML autonome affiché sur le site public partout où son `id` est référencé (par ex. sur la page d’accueil touristique via `homepage.aiContentBlockId` dans la configuration Travel, ou dans l’introduction d’un groupe d’événements à sessions multiples). Contient le HTML avec des clés `data-i18n` ainsi que le dictionnaire `i18n` de leurs traductions.",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "html": {
            "type": "string",
            "description": "Fragment HTML du bloc (avec attributs data-i18n)."
          },
          "mainLang": {
            "type": "string",
            "nullable": true,
            "description": "Langue par défaut utilisée pour rédiger le HTML."
          },
          "i18n": {
            "type": "object",
            "description": "Traductions : { lang: { i18nKey: value } } pour les clés data-i18n du HTML.",
            "additionalProperties": true
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers des ressources référencées dans le HTML."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "ContentBlockContentInput": {
        "type": "object",
        "description": "Contenu HTML d’un bloc IA. Envoyez du HTML BRUT — vous n’avez PAS à gérer vous-même les clés de traduction : le serveur ajoute un attribut `data-i18n=\"<key>\"` sur chaque nœud de texte traduisible qui n’en possède pas (et `data-i18n-alt`/`-title`/`-placeholder`/`-aria-label` pour ces attributs), en générant des clés telles que `auto_1`. Le texte de `mainLang` devient le dictionnaire de référence ; les traductions existantes des autres langues sont conservées et les clés obsolètes supprimées (conservez donc les clés data-i18n existantes lorsque vous modifiez de nouveau le contenu). Le bloc est affiché partout où son identifiant est référencé (par ex. sur la page d’accueil touristique).\n\nRÈGLES DE RÉDACTION OBLIGATOIRES pour le HTML (identiques à celles de l’éditeur IA intégré, puisqu’aucun éditeur ne peut les imposer ici) :\n• Produisez uniquement un FRAGMENT — aucun <!DOCTYPE>, <html>, <head> ni <body> ; commencez directement par <section>/<div>/<article>.\n• Placez tout le contenu dans un conteneur centré : max-width:1200px ; margin:0 auto ; padding latéral de 24px sur ordinateur / 16px sur mobile.\n• Préfixez TOUTES les classes CSS par `.aicb-` (par ex. .aicb-hero, .aicb-card) pour éviter les conflits avec la page hôte.\n• N’utilisez JAMAIS les unités de hauteur de fenêtre vh/vmin/vmax (le bloc est affiché dans une iframe à hauteur automatique → boucle infinie) ; utilisez px/rem ou min-height:600px pour les sections de bannière principale. vw (largeur) est autorisé.\n• Placez <style> AU DÉBUT du fragment et tout <script> À LA FIN. CSS natif uniquement (flexbox/grid/variables/@keyframes).\n• Polices : Google Fonts via @import dans <style> (Inter, Plus Jakarta Sans, DM Sans). Icônes : Lucide via CDN (<script src=\"https://unpkg.com/lucide@latest\"></script> + lucide.createIcons(), <i data-lucide=\"...\">).\n• Il s’agit d’un site communautaire JUIF : n’introduisez JAMAIS de symbole/icone/emoji d’une autre religion (Lucide `church`/`cross`…, emojis ✝️⛪☦️☪️🕌🛕☸️🔯). Les symboles juifs (✡️ 🕎) et les icônes/emojis neutres conviennent.\n• Évitez le texte blanc sur une carte colorée (lisibilité).",
        "required": [
          "html"
        ],
        "properties": {
          "html": {
            "type": "string",
            "description": "Fragment HTML du bloc. Les clés data-i18n sont ajoutées automatiquement. Respectez les règles de rédaction ci-dessus."
          },
          "mainLang": {
            "type": "string",
            "description": "Langue utilisée pour rédiger le HTML (par ex. \"fr\"). Par défaut, mainLang actuel du bloc ou langue par défaut de l’organisation."
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers facultatifs des ressources référencées dans le HTML."
          }
        }
      },
      "ContentBlockTranslationsInput": {
        "type": "object",
        "description": "Traductions des clés data-i18n existantes d’un bloc de contenu pour une langue. Ne modifie pas le HTML. Lisez le bloc (`i18n` et les clés `data-i18n` de `html`) pour découvrir les clés.",
        "required": [
          "lang",
          "dict"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "description": "Code de la langue cible (par ex. \"en\", \"he\")."
          },
          "dict": {
            "type": "object",
            "description": "{ i18nKey: translatedValue } (valeur traduite).",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
