Lister les colonnes avec l'API SharePoint
Liste les colonnes d'une liste avec name, displayName, required, readOnly et la facette de leur type, comme text, number, dateTime, boolean ou choice avec les choix autorisés. Le name, et non le displayName, est la clé d'une colonne dans fields.
- Identifiant
- sharepoint_list_columns
L'appel
POST https://connect.reportei.com/api/tools/sharepoint_list_columns/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"site_id": "<site_id>",
"list_id": "<list_id>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| site_id | string | Oui | Site id from Search sites, in the form hostname,guid,guid, or root for the root site of the organization. |
| list_id | string | Oui | List id from List lists. |
Connexions possibles
Votre client connecte son compte SharePoint une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/sharepoint, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/sharepoint_list_columns. Il devient la définition de tool de votre agent sans conversion.
Autres tools SharePoint
- Rechercher des sitesGETRecherche les sites SharePoint de l'organisation par mot-clé et renvoie id, displayName, name, webUrl et description. Utilisez l'id comme site_id. Seule la première page est renvoyée.
- Obtenir un siteGETRenvoie un site avec id, displayName, name, description, webUrl et createdDateTime.
- Lister les listesGETListe les listes et bibliothèques de documents d'un site, avec id, name, displayName, webUrl et list.template, qui vaut genericList pour une liste et documentLibrary pour une bibliothèque. Les listes système masquées sont exclues. Seule la première page est renvoyée.
- Lister les élémentsGETListe les éléments d'une liste avec id, webUrl, createdBy et lastModifiedDateTime, plus les valeurs des colonnes dans fields quand expand vaut fields. Dans une bibliothèque de documents, chaque élément est un fichier ou un dossier. Seule la première page est renvoyée.
- Obtenir un élémentGETRenvoie un élément d'une liste avec id, webUrl, createdBy et lastModifiedDateTime, plus les valeurs des colonnes dans fields quand expand vaut fields.
- Créer un élémentPOSTCrée un élément dans une liste et le renvoie avec son id et les valeurs enregistrées. Chaque colonne obligatoire de Lister les colonnes doit figurer dans fields.
- Supprimer un élémentDELETESupprime un élément d'une liste.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
