Pular para o conteúdo principal

Formatos de dados

Por padrão, o Sheet Best retorna as linhas como uma lista de registros. Adicione o parâmetro opcional _format a qualquer GET para alterar a estrutura da resposta. Adicione _raw=1 para retornar tipos nativos (números, booleanos) em vez de strings.

O parâmetro _format

FormatoEstrutura
records[{column: value}, ..., {column: value}] (padrão)
dict{column: {index: value}}
list{column: [values]}
series{column: Series(values)}
split{index: [...], columns: [...], data: [...]}
index{index: {column: value}}

Exemplo

curl 'https://api.sheetbest.com/sheets/<id>?_format=records'
curl 'https://api.sheetbest.com/sheets/<id>?_format=dict'
curl 'https://api.sheetbest.com/sheets/<id>?_format=list'
curl 'https://api.sheetbest.com/sheets/<id>?_format=series'
curl 'https://api.sheetbest.com/sheets/<id>?_format=split'
curl 'https://api.sheetbest.com/sheets/<id>?_format=index'

Records (padrão)

Formato records

Dict

Formato dict

List

Formato list

Series

Formato series

Split

Formato split

Index

Formato index

Retornar tipos nativos com _raw

Por padrão, os valores das células são retornados como strings. Adicione _raw=1 para obter números, booleanos e outros tipos JSON nativos.

# Default: values are strings
curl 'https://api.sheetbest.com/sheets/<id>'

# Native types
curl 'https://api.sheetbest.com/sheets/<id>?_raw=1'
ModoValor de exemplo
Padrão (string)"42"
_raw=142

Saída JSON padrão

Saída JSON com tipos nativos

_raw pode ser combinado com qualquer valor de _format.