Aurabase Logo
aurabasedocs
API/Database/Lire des lignes

Lire des lignes

GET/v1/db/{project_id}/{table}

Interroge une table avec filtres, ordre, pagination et joins. PostgREST sous le capot, RLS appliquée automatiquement.

#
Request

En-têtes

apikeyREQUIS
Clé API du projet (anon ou service_role). X-API-Key accepté aussi.
Authorization
Bearer <JWT utilisateur> — sans lui, la requête est traitée en anon
#
Request

Query parameters

selectstringOPTIONNEL
Colonnes à retourner. * par défaut. Embed de relations (FK) : posts(*), author:authors(name).
orderstringOPTIONNEL
captured_at.desc · name.asc. Le placement des NULL (.nullsfirst/.nullslast) n'est honoré sur MongoDB que dans sa forme native (asc.nullsfirst, desc.nullslast) ; les deux autres combinaisons sont refusées en 400 plutôt que de rendre un ordre différent de celui demandé.
limitintegerOPTIONNEL
Nombre max de lignes. Défaut 1000, max 1000 — au-delà, la réponse est plafonnée et meta.per_page indique la limite réellement appliquée.
offsetintegerOPTIONNEL
Offset de pagination. Seule pagination disponible sur PostgREST, le moteur nominal d'un projet Postgres.
cursorstringOPTIONNEL
aura-db uniquement (MongoDB, ou Postgres avec PostgREST désactivé) — non disponible sur PostgREST, qui répond 400 en nommant offset. Pagination keyset : renvoyer tel quel le meta.next_cursor opaque de la page précédente. Stable, sans dup/skip (int/uuid/text). S'aligne sur sort_by.
countenumOPTIONNEL
exact ou estimated. Aucun comptage n'est fait par défaut. C'est la forme portable : sur le chemin aura-db, seul ce paramètre de requête est lu — un en-tête Prefer: count=exact y serait ignoré (il n'est honoré que par PostgREST).
<column>.<op>filterOPTIONNEL
Filtres : value.gt.24, status.eq.active, name.like.%alice%, tags.cs.{urgent}.
#
Notes

À savoir

Astuce
Embed de relations (FK) via select : author:authors(name) (LEFT JOIN — les lignes sans relation retournent null). Le filtrage inner-join !inner n'est pas encore supporté.
Attention
L'en-tête Range n'est pas une pagination alternative universelle : le chemin aura-db (projet MongoDB, ou Postgres avec PostgREST désactivé) ne lit que les paramètres de requête et l'ignore purement et simplement. Il n'a d'effet que si la requête atteint PostgREST. Utilisez limit/offset.
Attention
La réponse est enveloppée : { data, meta }, jamais un tableau nu. Sur le chemin PostgREST, meta ne contient que total (et seulement si un comptage a été demandé) ; sur le chemin aura-db il porte aussi per_page et next_cursor.
Attention
Les colonnes numeric/decimal sont renvoyées en string (ex. "19.99") pour préserver la précision exacte — scalaires ET tableaux. Parser côté client (Number(), Decimal) avant tout calcul ; ne pas typer number.
v1.0 · révisé 15 avr. 2026