본문 바로가기
WIKI 기술 지식 베이스

Turso Platform API

원문 보기 위키 갱신

Turso Platform API로 데이터베이스, 그룹, 조직, 토큰을 코드로 관리하는 방법을 안내해요. 공식 TypeScript SDK가 가장 빠른 시작점이에요.

출처: 문서

본문

Platform API로 데이터베이스, 그룹, 조직, 토큰을 프로그래밍 방식으로 관리해요.

TypeScript SDK로 빠르게 시작하기

JavaScript나 TypeScript에서 Platform API를 가장 빠르게 쓰는 방법은 공식 @tursodatabase/api 클라이언트예요:

npm install @tursodatabase/api

import { createClient } from "@tursodatabase/api";

const turso = createClient({
  org: process.env.TURSO_ORG!,
  token: process.env.TURSO_PLATFORM_TOKEN!,
});

// 데이터베이스 만들기
const db = await turso.databases.create("user-abc123", { group: "default" });

// 그 데이터베이스의 범위가 지정된 인증 토큰 발급
const { jwt } = await turso.databases.createToken("user-abc123");

// 더 이상 필요 없으면 삭제
await turso.databases.delete("user-abc123");

원시 HTTP 레퍼런스가 필요하면 아래 리소스 엔드포인트 문서를 보세요.

자주 쓰는 활용 사례

사용자별 데이터베이스 / 에이전트별 데이터베이스 (멀티 테넌트)

사용자별 또는 AI 에이전트별로 전용 데이터베이스를 프로비저닝해요. 각 엔티티는 API로 만들고, 토큰 범위를 지정하고, 정리하는 자기만의 격리된 SQLite 데이터베이스를 갖게 돼요.

import { createClient } from "@tursodatabase/api";

const turso = createClient({
  org: process.env.TURSO_ORG!,
  token: process.env.TURSO_PLATFORM_TOKEN!,
});

// 사용자 가입 또는 에이전트 생성 시 — 데이터베이스 프로비저닝
const db = await turso.databases.create(`agent-${agentId}`, { group: "default" });

// 그 데이터베이스의 범위 지정 토큰 발급
const { jwt } = await turso.databases.createToken(`agent-${agentId}`);

// 세션을 위해 db.hostname과 jwt를 저장

데이터베이스를 만들었으면 애플리케이션에서 연결해요:

  • 네트워크를 통해 — @tursodatabase/serverless로 원격으로 데이터베이스를 쿼리해요
  • 로컬 퍼스트 + 동기화 — @tursodatabase/sync로 로컬 파일과 데이터베이스를 양방향 동기화해요

플랫폼 / 리셀러

최종 사용자를 대신해 데이터베이스를 만들고 관리해요. Platform API를 써서 Turso 위에 여러분만의 database-as-a-service를 만들 수 있어요.

// 조직의 모든 데이터베이스 나열
const databases = await turso.databases.list();

// 특정 데이터베이스 상세 조회
const db = await turso.databases.get("customer-db");

API Quickstart: API로 첫 데이터베이스를 만드는 단계별 가이드는 여기에서 볼 수 있어요.

API 리소스

몇 가지 간단한 단계만 거치면 여러분의 플랫폼에 Turso API를 통합할 수 있어요.

더 알아보기 (Learn more)