airtable

API AirTable de Golang

Un paquete simple #Golang para acceder a la API AirTable.

Tabla de contenido

• API AirTable de Golang
• Tabla de contenido
  • Instalación
  • Uso básico
    • Inicializar el cliente
    • Conseguir una mesa
    • Lista de registros
    • Agregar registros
    • Obtener registro por identificación
    • Registros de actualización
    • Eliminar registro
    • Registros de eliminación a granel
  • Agradecimiento especial

Instalación

La API AirTable de Golang se ha probado compatible con GO 1.13 en UP.

 go get github.com/mehanizm/airtable

Uso básico

Inicializar el cliente

Debe obtener your_api_token en la página de la cuenta de AirTable

 client := airtable . NewClient ( "your_api_token" )

Puede usar el cliente HTTP personalizado aquí

 client . SetCustomClient ( http . DefaultClient )

Contexto personalizado

Cada método a continuación se puede usar con contexto personalizado. Simplemente use la llamada MethodNameContext y proporcione el contexto como primer argumento.

Lista de bases

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

Obtener esquema base

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

Conseguir una mesa

Para obtener el your_database_ID , debe ir a la página API principal y seleccionar la base de datos.

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

Lista de registros

Para obtener registros de la tabla, puede usar algo como esto

 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
}

Agregar 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
}

Obtener registro por identificación

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

Registros de actualización

Para actualizar parcial un registro

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

A los registros de actualización completa

 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
}

Eliminar registro

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

Registros de eliminación a granel

Para eliminar hasta 10 registros

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

Agradecimiento especial

Inspirado por Go Trello API