Alfresco¶

Les neuf routes publiées sur cette page sont des routes d'administration intégratrice. Elles exigent l'authentification REST et le privilège admin_alfresco.

Lire la configuration¶

GET /rest/alfresco/configuration

La réponse 200 OK contient {"configuration": null} lorsque le connecteur n'est pas configuré, sinon :

{
  "configuration": {
    "uri": "https://alfresco.example.invalid"
  }
}

Modifier la configuration¶

PUT /rest/alfresco/configuration
Content-Type: application/json

{
  "uri": "https://alfresco.example.invalid"
}

uri doit être une chaîne. Le succès retourne 204 No Content et un body invalide retourne 400 Bad Request.

Lister les entités disponibles¶

GET /rest/alfresco/availableEntities

La réponse 200 OK contient availableEntities, tableau des identifiants d'entités qui ne sont pas encore liées à un compte Alfresco.

{
  "availableEntities": [3, 7]
}

Lister les comptes¶

GET /rest/alfresco/accounts

La réponse 200 OK contient accounts. Chaque compte expose id, label, login et entitiesLabel. Aucun mot de passe n'est retourné.

Consulter un compte¶

GET /rest/alfresco/accounts/{id}

Paramètre	Emplacement	Type	Description
`id`	chemin	string	Identifiant technique du compte

La réponse 200 OK expose id, label, login, nodeId et les identifiants entities. Un compte absent produit 400 Bad Request.

Créer un compte¶

POST /rest/alfresco/accounts
Content-Type: application/json

{
  "label": "Compte de versement",
  "login": "alfresco-user",
  "password": "<secret-non-reproduit>",
  "nodeId": "node-example",
  "entities": [3, 7]
}

Propriété	Type	Obligatoire	Description
`label`	string non vide	oui	Libellé
`login`	string non vide	oui	Identifiant Alfresco
`password`	string non vide	oui	Mot de passe chiffré avant stockage
`nodeId`	string non vide	oui	Nœud racine
`entities`	array d'integers	oui	Entités existantes à rattacher

Le succès retourne 204 No Content. Une propriété invalide, une entité inconnue ou un compte absent produit 400 Bad Request.

Modifier un compte¶

PUT /rest/alfresco/accounts/{id}
Content-Type: application/json

Le body reprend label, login, nodeId et entities. password est facultatif : s'il est vide, le secret chiffré existant est conservé. Les rattachements d'entités sont remplacés. Le succès retourne 204 No Content.

Supprimer un compte¶

DELETE /rest/alfresco/accounts/{id}

Le connecteur Alfresco est retiré de toutes les entités liées au compte. Le succès retourne 204 No Content et un compte absent retourne 400 Bad Request.

Tester un compte¶

POST /rest/alfresco/checkAccounts
Content-Type: application/json

Propriété	Type	Obligatoire	Description
`login`	string non vide	oui	Identifiant à tester
`password`	string	conditionnel	Obligatoire si `accountId` ne permet pas de réutiliser le secret stocké
`accountId`	string	conditionnel	Compte dont le secret stocké doit être utilisé
`nodeId`	string	non	Nœud dont les sous-dossiers sont testés

{
  "login": "alfresco-user",
  "accountId": "account-example",
  "nodeId": "node-example"
}

Le succès retourne 204 No Content. Une configuration absente, des identifiants incomplets, un compte inconnu ou une erreur Alfresco retourne 400 Bad Request. Toutes les routes de cette page retournent 403 Forbidden lorsque le privilège admin_alfresco manque.

Routes privées non publiées¶

Les routes suivantes sont consommées par l'interface de versement, utilisent le compte de l'entité primaire de l'utilisateur et n'appliquent pas le privilège admin_alfresco :

Route	Classement
`GET /rest/alfresco/rootFolders`	Privée applicative
`GET /rest/alfresco/folders/{id}/children`	Privée applicative
`GET /rest/alfresco/autocomplete/folders`	Privée applicative