Data API базы: проба метода
data_api_probeA real request to a method through the gateway — as a visitor, a user or the server.
The platform supplies the key and the token. Writes (POST, PATCH, DELETE,
a function call) are rolled back: rows in the database do not change,
but the rollback does not undo sequence numbers, calls from the database
to the outside, session locks or the daily call quota. The answer is
real: grants, row policies and refusals are the same the site will see.
Needs a token with the admin scope.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Body for POST and PATCH. | |
| path | Yes | Path from the database address: `/rest/v1/products`, `/rest/v1/rpc/order_create` or `/whoami` (GET only). | |
| role | No | On whose behalf: visitor — a visitor with the public key, user — a signed-in user (needs user_id), server — the secret key. | visitor |
| query | No | Query parameters, PostgREST style: {"select": "id,title", "price": "gt.100"}. | |
| method | Yes | HTTP method. | |
| schema | No | The table's schema: api, public or app. Without it the name is looked up in the order api → public → app — pass it when tables with the same name exist in several schemas. Not needed for functions and /whoami. | |
| user_id | No | For role=user: id of the app user. | |
| database | No | The database: name, slug or id. Without it — the organization's only database with the Data API enabled. | |
| organization | No | Organization slug. Without it — the only one, or the personal one. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | ||
| rows | No | ||
| total | No | ||
| caller | No | ||
| status | No | ||
| request | Yes | ||
| database | Yes | ||
| elapsed_ms | No | ||
| next_action | Yes | ||
| owner_total | No | ||
| rolled_back | No | ||
| organization | Yes | ||
| body_shortened | No | ||
| body_truncated | No | ||
| rollback_expected | No |