**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)

# WordPress

OpenAPI 3.0.3 · API 1.0.0

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

## Opérations

## GET /wordpress/catalog

Lister le contenu public associé à l’organisation connectée

`list_wordpress_catalog`

Autorisation requise : `wordpress:read`. Métadonnées réservées à l’éditeur authentifié. Le contenu public est disponible automatiquement. resourceAccess est public ; le champ historique de sélection contient tous les identifiants renvoyés pour les anciens plugins. Ce n’est pas une opération anonyme destinée au navigateur.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

### OpenAPI

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

## PUT /wordpress/selection

Enregistrer les préférences de contenu historique pour les anciens plugins

`update_wordpress_selection`

Autorisation requise : `wordpress:publish`. La connexion nécessite également wordpress:read. Les identifiants sont revérifiés par rapport aux ressources publiques de son organisation. Les préférences enregistrées ne restreignent plus l’accès au contenu public.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "wordpress:publish",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "selection"
        ],
        "properties": {
          "selection": {
            "type": "object",
            "properties": {
              "donation": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "forms": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "events": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "caisses": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "pages": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "galleries": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /wordpress/data/{kind}

Lire les modules publics de l’organisation

`get_wordpress_data`

Autorisation requise : `wordpress:read`. L’appartenance à l’organisation et la disponibilité publique active sont vérifiées à chaque requête. Les montants sont des entiers en unités mineures, avec une devise par collection.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "kind",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "donation",
      "forms",
      "events",
      "caisses",
      "pages",
      "galleries"
    ]
  }
}
```

```json
{
  "name": "id",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "lang",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 24
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Ressource indisponible, inactive ou appartenant à une autre organisation"
}
```

### OpenAPI

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

## DELETE /wordpress/connection

Déconnecter ce site WordPress

`delete_wordpress_connection`

Autorisation requise : `wordpress:read`. Supprime uniquement les paramètres de publication de cette clé ; révoque les jetons OAuth, mais ne révoque pas une clé d’intégration fournie manuellement.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /wordpress/releases/stable

Lire le manifeste signé de version du plugin

`list_wordpress_releases_stable`

Opération publique, indépendante de l’abonnement au compte. Construit et met automatiquement en cache la version du code déployée. Signature Ed25519 d’une charge utile JSON encodée en base64.

### Authentification

```json
[]
```

### Permissions requises

```json
{
  "accepted": null,
  "additional": []
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Manifeste signé",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "signed",
          "signature"
        ],
        "properties": {
          "signed": {
            "type": "string"
          },
          "signature": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Génération de version temporairement indisponible ; réessayez plus tard"
}
```

### OpenAPI

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

## Schémas

```json
{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
