Passer au contenu principal
POST
/
table
/
query
Requête sur le tableau
curl --request POST \
  --url https://api.example.com/table/query \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "digest": "<string>",
  "filter": {
    "row_digests": [
      "aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims",
      "aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims"
    ]
  },
  "limit": 100,
  "offset": 10,
  "sort_by": [
    {
      "field": "col_a.prop_b",
      "order": "desc"
    }
  ]
}
'
{
  "rows": [
    {
      "digest": "<string>",
      "val": "<unknown>",
      "original_index": 123
    }
  ]
}

Autorisations

Authorization
string
header
requis

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Corps

application/json
project_id
string
requis

L’ID du projet

Exemple:

"my_entity/my_project"

digest
string
requis

L’empreinte du tableau à interroger

Exemple:

"aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims"

filter
TableRowFilter · object

Filtre facultatif à appliquer à la requête. Voir TableRowFilter pour plus de détails.

Exemple:
{
"row_digests": [
"aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims",
"aonareimsvtl13apimtalpa4435rpmgnaemrpgmarltarstaorsnte134avrims"
]
}
limit
integer | null

Nombre maximal de lignes à renvoyer

Exemple:

100

offset
integer | null

Nombre de lignes à ignorer avant de commencer à renvoyer des lignes

Exemple:

10

sort_by
SortBy · object[] | null

Liste des champs selon lesquels trier. Les champs peuvent être séparés par des points pour accéder aux valeurs du dictionnaire. Si aucun tri n’est appliqué, l’ordre par défaut du tableau est utilisé (ordre d’insertion).

Exemple:
[
{ "field": "col_a.prop_b", "order": "desc" }
]

Réponse

Réponse réussie

rows
TableRowSchema · object[]
requis