API Grist et Python : Guide Complet avec Exemples

L'un des grands atouts de Grist est son API REST très complète. Elle permet de connecter votre base de données à n'importe quel autre système. Voici comment l'utiliser avec Python.

1. Prérequis

Vous aurez besoin de votre clé API (disponible dans les paramètres de votre profil Grist) et de l'ID de votre document (visible dans l'URL du document).

2. Lire des données (GET)

Voici comment récupérer les enregistrements d'une table nommée "Clients" :

import requests

API_KEY = "votre_cle_api"
DOC_ID = "votre_doc_id"
TABLE_ID = "Clients"

url = f"https://docs.getgrist.com/api/docs/{DOC_ID}/tables/{TABLE_ID}/records"
headers = {"Authorization": f"Bearer {API_KEY}"}

response = requests.get(url, headers=headers)
data = response.json()

for record in data['records']:
    print(record['fields']['Nom'])

3. Ajouter des données (POST)

Pour insérer de nouvelles lignes depuis un script externe :

new_records = {
  "records": [
    {"fields": {"Nom": "Dupont", "Email": "[email protected]"}},
    {"fields": {"Nom": "Martin", "Email": "[email protected]"}}
  ]
}

response = requests.post(url, headers=headers, json=new_records)
print(response.status_code)

4. Cas d'usage

L'API est idéale pour :

• Synchroniser Grist avec un site e-commerce (ex: WooCommerce, Shopify).
• Créer des scripts de sauvegarde personnalisés.
• Alimenter Grist depuis des formulaires web externes.

💡 Besoin d'intégrations complexes ?
En tant qu'expert Grist freelance, je développe des scripts Python sur mesure pour automatiser vos flux de données entre Grist et vos autres logiciels.