Aller au contenu

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/posts

Paramètres de requête :

ParamètreExempleEffet
selectid,title,created_atColonnes à retourner (défaut : *)
ordercreated_at.descColonne de tri et direction
limit20Nombre maximum de lignes
offset40Ignorer des lignes (pour la pagination)
{col}published=eq.trueFiltre : 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/posts
Content-Type: application/json
Prefer: 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.