API Base de données (REST)
import { Aside } from ‘@astrojs/starlight/components’
L’API REST pour interroger les tables suit les conventions PostgREST.
Chemin de base
/{stage}/db/{database-name}/rest/{table-name}GET — sélectionner des lignes
GET /production/db/main/rest/postsParamètres de requête :
| Paramètre | Exemple | Effet |
|---|---|---|
select | id,title,created_at | Colonnes à retourner (défaut : *) |
order | created_at.desc | Colonne de tri et direction |
limit | 20 | Nombre maximum de lignes |
offset | 40 | Ignorer des lignes (pour la pagination) |
{col} | published=eq.true | Filtre : col=op.value |
Opérateurs de filtre : eq, neq, gt, gte, lt, lte, like, ilike, is, in, cs, cd.
POST — insérer des lignes
POST /production/db/main/rest/postsContent-Type: application/jsonPrefer: return=representation
{ "title": "Bonjour", "body": "..." }Passez un tableau pour les insertions en masse.
PATCH — mettre à jour des lignes
PATCH /production/db/main/rest/posts?id=eq.{uuid}Content-Type: application/json
{ "title": "Mis à jour" }Incluez toujours un filtre pour éviter de mettre à jour toutes les lignes.
DELETE — supprimer des lignes
DELETE /production/db/main/rest/posts?id=eq.{uuid}Incluez toujours un filtre.