Airtable API 베이스 목록

Airtable API 베이스 목록

Airtable API의 사용자 메타데이터 엔드포인트 중 하나로, 현재 액세스 토큰이 접근할 수 있는 베이스(base) 목록을 조회하는 기능이에요. GET /v0/meta/bases 요청을 보내면 각 베이스의 ID와 이름, 그리고 권한 수준까지 한 번에 확인할 수 있어요. 여러 베이스를 운영하거나 어떤 베이스에 접근 가능한지 파악해야 할 때 유용하죠. 이 페이지에서는 요청 방법, 응답 형식, 그리고 실제 예시까지 차근차근 설명할게요.

출처: 문서

본문

엔드포인트

베이스 목록을 가져오는 API는 다음과 같아요.

GET /v0/meta/bases

이 엔드포인트는 토큰이 접근할 수 있는 베이스 목록을 한 번에 1000개씩 반환해요. 만약 다음 페이지가 더 있다면, 응답에서 받은 offset 값을 URL 쿼리 파라미터로 다시 넘겨서 이어서 조회할 수 있어요.

GET /v0/meta/bases?offset=itr23sEjsdfEr3282/appSW9R5uCNmRmfl6

인증

이 API는 OAuth 액세스 토큰 또는 개인 액세스 토큰(PAT)으로 인증할 수 있어요. OAuth를 사용한다면 schema.bases:read 스코프가 필요해요.

쿼리 파라미터

응답 형식

200 응답은 아래 필드로 구성돼요.

• bases (필수, 배열) — 접근 가능한 베이스 목록. 각 항목은 다음 필드를 가져요.
  • id (필수) — 베이스의 고유 식별자(Base ID)
  • name (필수) — 베이스 이름
  • permissionLevel (필수) — 권한 수준. none, read, comment, edit, create, interfaceOnly 중 하나예요.
• offset (string) — 다음 페이지를 불러올 때 사용하는 커서 값이에요. 더 가져올 데이터가 없으면 없을 수 있어요.

다음은 실제 응답 예시예요.

{
  "bases": [
    {
      "id": "appLkNDICXNqxSDhG",
      "name": "Apartment Hunting",
      "permissionLevel": "create"
    },
    {
      "id": "appSW9R5uCNmRmfl6",
      "name": "Project Tracker",
      "permissionLevel": "edit"
    }
  ],
  "offset": "itr23sEjsdfEr3282/appSW9R5uCNmRmfl6"
}

사용 예시

curl로 개인 액세스 토큰을 Authorization 헤더에 담아 베이스 목록을 조회할 수 있어요.

curl -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  "https://api.airtable.com/v0/meta/bases"

응답의 bases 배열을 돌면서 각 베이스의 id와 name, permissionLevel을 활용하면 돼요. 베이스가 1000개를 넘어간다면 응답의 offset을 다음 요청의 쿼리 파라미터로 넘겨 모든 베이스를 순차적으로 가져올 수 있어요.

더 알아보기 (Learn more)

• 공식 문서