airtable

API Airtable Golang

Um pacote #Golang simples para acessar a API Airtable.

Índice

• API Airtable Golang
• Índice
  • Instalação
  • Uso básico
    • Inicialize o cliente
    • Obtenha a mesa
    • Listos registros
    • Adicione registros
    • Obtenha recorde por id
    • Atualizar registros
    • Excluir registro
    • Bulk Excluir registros
  • Obrigado especial

Instalação

A API Airtable Golang foi testada compatível com o GO 1.13 no UP.

 go get github.com/mehanizm/airtable

Uso básico

Inicialize o cliente

Você deve obter your_api_token na página da conta Airtable

 client := airtable . NewClient ( "your_api_token" )

Você pode usar o cliente HTTP personalizado aqui

 client . SetCustomClient ( http . DefaultClient )

Contexto personalizado

Cada método abaixo pode ser usado com contexto personalizado. Simplesmente use MethodNameContext Ligue e forneça o contexto como primeiro argumento.

Bases de lista

 bases , err := client . GetBases (). WithOffset ( "" ). Do ()

Obtenha esquema base

 schema , err := client . GetBaseSchema ( "your_database_ID" ). Do ()

Obtenha a mesa

Para obter o your_database_ID , você deve acessar a página da API principal e selecionar o banco de dados.

 table := client . GetTable ( "your_database_ID" , "your_table_name" )

Listar registros

Para obter registros da tabela, você pode usar algo assim

 records , err := table . GetRecords ().
	FromView ( "view_1" ).
	WithFilterFormula ( "AND({Field1}='value_1',NOT({Field2}='value_2'))" ).
	WithSort ( sortQuery1 , sortQuery2 ).
	ReturnFields ( "Field1" , "Field2" ).
	InStringFormat ( "Europe/Moscow" , "ru" ).
	Do ()
if err != nil {
	// Handle error
}

Adicione registros

 recordsToSend := & airtable. Records {
    Records : [] * airtable. Record {
        {
            Fields : map [ string ] any {
                "Field1" : "value1" ,
                "Field2" : true ,
            },
        },
    },
}
receivedRecords , err := table . AddRecords ( recordsToSend )
if err != nil {
	// Handle error
}

Obtenha recorde por id

 record , err := table . GetRecord ( "recordID" )
if err != nil {
	// Handle error
}

Atualizar registros

Para atualizar parcial um registro

 res , err := record . UpdateRecordPartial ( map [ string ] any { "Field_2" : false })
if err != nil {
	// Handle error
}

Para registros completos de atualização

 toUpdateRecords := & airtable. Records {
    Records : [] * airtable. Record {
        {
            Fields : map [ string ] any {
                "Field1" : "value1" ,
                "Field2" : true ,
            },
        },
        {
            Fields : map [ string ] any {
                "Field1" : "value1" ,
                "Field2" : true ,
            },
        },
    },
}
updatedRecords , err := table . UpdateRecords ( toUpdateRecords )
if err != nil {
	// Handle error
}

Excluir registro

 res , err := record . DeleteRecord ()
if err != nil {
	// Handle error
}

Bulk Excluir registros

Para excluir até 10 registros

 records , err := table . DeleteRecords ([] string { "recordID1" , "recordsID2" })
if err != nil {
	// Handle error
}

Obrigado especial

Inspirado pela API Go Trello