0

Get Record

by
Published Jun 6, 2022

Retrieve one record by its ID.

Script airtable Verified

The script

Submitted by hugo989 Typescript (fetch-only)
Verified 5 days ago
1
//native
2

3
export type DynSelect_base_id = string
4
export type DynSelect_table_id = string
5

6
// Dropdown of the bases the token can access.
7
export async function base_id(auth: RT.Airtable) {
8
  const options: { value: string; label: string }[] = []
9
  let offset: string | undefined = undefined
10
  do {
11
    const url = new URL("https://api.airtable.com/v0/meta/bases")
12
    if (offset) {
13
      url.searchParams.append("offset", offset)
14
    }
15
    const response = await fetch(url, {
16
      headers: {
17
        Authorization: `Bearer ${auth.apiKey}`,
18
        Accept: "application/json",
19
      },
20
    })
21
    if (!response.ok) {
22
      throw new Error(`${response.status} ${await response.text()}`)
23
    }
24
    const page = (await response.json()) as {
25
      bases: { id: string; name: string }[]
26
      offset?: string
27
    }
28
    options.push(...page.bases.map((b) => ({ value: b.id, label: b.name })))
29
    offset = page.offset
30
  } while (offset)
31
  return options
32
}
33

34
async function listTables(auth: RT.Airtable, base_id: string) {
35
  if (!base_id) {
36
    return []
37
  }
38
  const response = await fetch(
39
    `https://api.airtable.com/v0/meta/bases/${base_id}/tables`,
40
    {
41
      headers: {
42
        Authorization: `Bearer ${auth.apiKey}`,
43
        Accept: "application/json",
44
      },
45
    }
46
  )
47
  if (!response.ok) {
48
    throw new Error(`${response.status} ${await response.text()}`)
49
  }
50
  const { tables } = (await response.json()) as {
51
    tables: {
52
      id: string
53
      name: string
54
      fields: { id: string; name: string; type: string }[]
55
      views: { id: string; name: string }[]
56
    }[]
57
  }
58
  return tables
59
}
60

61
// Dropdown of the tables in the chosen base.
62
export async function table_id(auth: RT.Airtable, base_id: DynSelect_base_id) {
63
  return (await listTables(auth, base_id)).map((t) => ({
64
    value: t.id,
65
    label: t.name,
66
  }))
67
}
68

69
/**
70
 * Get Record
71
 * Retrieve one record by its ID (starts with rec).
72
 */
73
export async function main(
74
  auth: RT.Airtable,
75
  base_id: DynSelect_base_id,
76
  table_id: DynSelect_table_id,
77
  record_id: string,
78
  return_fields_by_field_id: boolean | undefined
79
) {
80
  const url = new URL(
81
    `https://api.airtable.com/v0/${base_id}/${table_id}/${record_id}`
82
  )
83
  if (return_fields_by_field_id === true) {
84
    url.searchParams.append("returnFieldsByFieldId", "true")
85
  }
86

87
  const response = await fetch(url, {
88
    headers: {
89
      Authorization: `Bearer ${auth.apiKey}`,
90
      Accept: "application/json",
91
    },
92
  })
93
  if (!response.ok) {
94
    throw new Error(`${response.status} ${await response.text()}`)
95
  }
96

97
  return await response.json()
98
}
99

Other submissions
  • Submitted by rossmccrann Deno
    Created 1560 days ago
    1
    import { Airtable } from "https://deno.land/x/airtable/mod.ts";
    2
    
    
    3
    
    
    4
    export async function main(at_con: wmill.Resource<"airtable">, recordId: string) {
    5
        const airtable = new Airtable(at_con);
    6
    
    
    7
        const record = await airtable.find(recordId)
    8
      
    9
        return {result: record};
    10
    }
  • Submitted by henri186 Deno
    Created 529 days ago
    1
    import { Airtable } from "https://deno.land/x/airtable/mod.ts";
    2
    
    
    3
    type Airtable = {
    4
      apiKey: string;
    5
    };
    6
    
    
    7
    type AirtableTable = {
    8
      baseId: string;
    9
      tableName: string;
    10
    };
    11
    export async function main(
    12
      atCon: Airtable,
    13
      atTable: AirtableTable,
    14
      recordId?: string,
    15
    ) {
    16
      const airtable = new Airtable({ ...atCon, ...atTable });
    17
    
    
    18
      if (recordId) {
    19
        const record = await airtable.find(recordId);
    20
        return { result: record };
    21
      } else {
    22
        const records = await airtable.select().all();
    23
        return { result: records };
    24
      }
    25
    }
    26