Таблицы и представления

GET

/api/v1/tables

curl --request GET \
  --url https://demo.goodwink.ru/api/v1/tables \
  --header 'Authorization: Bearer <token>'

• адрес вашего кабинета

Объекты, которые можно читать: таблицы источников (схема sources), таблицы и представления клиента (public и свои схемы); без страниц

Authorizations

• bearer
• apiKey

Responses

200

Успех

Media typeapplication/json

object

data

required

Array<object>

object

schema

required

Sources — таблицы источников, public и свои схемы — объекты клиента

string

name

required

string

kind

required

Таблица, представление, материализованное представление

string

Allowed values: table view matview

source

required

One of:

object

object

id

required

integer

name

required

string

null

null

comment

required

Описание объекта (COMMENT ON)

string | null

rows_estimate

required

Оценка числа строк по каталогу Postgres; у представления null

integer | null

has_more

required

boolean

next_cursor

required

Передавайте как cursor, пока has_more

string | null

Example

{
  "data": [
    {
      "kind": "table"
    }
  ]
}

Headers

X-RateLimit-Limit

integer

Лимит запросов в минуту на ключ

X-RateLimit-Remaining

integer

Сколько осталось в этой минуте

400

Параметр не того вида, неизвестный (unknown_param) или выборка не применяется

Media typeapplication/json

object

error

required

object

type

required

string

Allowed values: invalid_request unauthorized not_found conflict rate_limited unavailable

code

required

Машинный код: unknown_param, bad_limit, bad_cursor, bad_source_id, bad_channel, bad_filter, bad_fo, bad_fv, bad_dir, bad_period, unknown_column, bad_columns, bad_selection, invalid_key, rate_limited, no_such_source, no_such_table, table_busy, query_failed, query_timeout, reader_off

string

message

required

Что ждали — словами

string

param

required

Виноватый параметр

string | null

Example

{
  "error": {
    "type": "invalid_request"
  }
}

401

Нет ключа, ключ неверный или отозван; WWW-Authenticate: Bearer

Media typeapplication/json

object

error

required

object

type

required

string

Allowed values: invalid_request unauthorized not_found conflict rate_limited unavailable

code

required

Машинный код: unknown_param, bad_limit, bad_cursor, bad_source_id, bad_channel, bad_filter, bad_fo, bad_fv, bad_dir, bad_period, unknown_column, bad_columns, bad_selection, invalid_key, rate_limited, no_such_source, no_such_table, table_busy, query_failed, query_timeout, reader_off

string

message

required

Что ждали — словами

string

param

required

Виноватый параметр

string | null

Example

{
  "error": {
    "type": "invalid_request"
  }
}

429

Превышен лимит запросов на ключ; Retry-After — через сколько секунд

Media typeapplication/json

object

error

required

object

type

required

string

Allowed values: invalid_request unauthorized not_found conflict rate_limited unavailable

code

required

Машинный код: unknown_param, bad_limit, bad_cursor, bad_source_id, bad_channel, bad_filter, bad_fo, bad_fv, bad_dir, bad_period, unknown_column, bad_columns, bad_selection, invalid_key, rate_limited, no_such_source, no_such_table, table_busy, query_failed, query_timeout, reader_off

string

message

required

Что ждали — словами

string

param

required

Виноватый параметр

string | null

Example

{
  "error": {
    "type": "invalid_request"
  }
}