Obtenir une page avec l'API Notion
Renvoie les propriétés d'une page. Le contenu n'est pas inclus : lisez-le avec Obtenir le markdown d'une page.
- Identifiant
- notion_retrieve_page
L'appel
POST https://connect.reportei.com/api/tools/notion_retrieve_page/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"page_id": "<page_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 |
|---|---|---|---|
| page_id | string | Oui | Id of the page, from Search or List data source pages, or the 32-character id at the end of the page URL. |
| filter_properties | array | Non | Names or ids of the properties to return, from Get data source. Omit it to return all of them. |
Connexions possibles
Votre client connecte son compte Notion une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/notion, 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/notion_retrieve_page. Il devient la définition de tool de votre agent sans conversion.
Autres tools Notion
- RechercherPOSTRecherche par titre les pages et data sources partagés avec la connexion. Renvoie has_more et next_cursor pour la page suivante.
- Créer une pagePOSTCrée une page sous une page ou un data source partagé avec la connexion. Envoyez le contenu en Markdown dans markdown, ou en blocs dans children, jamais les deux.
- Mettre à jour une pagePATCHMet à jour les propriétés, l'icône ou la couverture d'une page, ou la met à la corbeille et l'en sort avec in_trash. Les propriétés omises gardent leur valeur.
- Obtenir le markdown d'une pageGETRenvoie le contenu d'une page en Markdown dans le champ markdown. Sur une très grande page, truncated vaut true et unknown_block_ids liste les parties omises.
- Mettre à jour le markdown d'une pagePATCHModifie le contenu d'une page en Markdown : le type update_content applique des modifications par recherche et remplacement, et replace_content réécrit toute la page.
- Créer des blocsPATCHAjoute des blocs de contenu à une page, ou à un bloc qui accepte des enfants, à la fin sauf si position dit autre chose. Jusqu'à 100 blocs par appel.
- Obtenir une base de donnéesGETRenvoie une base de données avec titre, parent et data_sources, l'id et le name de chaque data source qu'elle contient.
- Obtenir un data sourceGETRenvoie le schéma d'un data source : nom, id, type et options de chaque propriété. Lisez-le avant de créer, mettre à jour ou filtrer des pages dedans.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
