API 키

외부 시스템이 이 워크스페이스의 테이블을 REST API 로 읽고 쓸 때 쓰는 키를 발급·관리합니다. 사이드바 API 키에서 엽니다(소유자·관리자 전용).

1. 키 발급

1. 오른쪽 위 새 키 발급을 누릅니다.
2. 이름을 적습니다(예: 주문연동 서버). 어디서 쓰는 키인지 알아볼 수 있는 이름이 좋습니다.
3. 권한을 고릅니다.
   • 모든 Table — 지금 있는 테이블과 앞으로 만들 테이블 전부.
   • Table 별 선택 — 고른 테이블에 고른 동작(조회·생성·수정·삭제·실행)만 허용. 선택하지 않은 테이블·동작은 모두 거부됩니다.
4. 발급을 누르면 키 원문이 한 번만 표시됩니다. 복사해 안전한 곳에 보관하세요. 창을 닫으면 다시 볼 수 없습니다.

2. 키 사용

• 요청 헤더에 넣습니다. Authorization: Bearer tr_live_…
• 주소는 https://api.tablerun.biz/v1 이고, 테이블별 엔드포인트와 예제 코드는 각 테이블의 API 탭에 실제 컬럼 이름으로 채워져 있습니다.
• 키 하나는 이 워크스페이스에만 접근하고, 발급 때 허용한 동작만 수행합니다.

3. 목록과 폐기

• 목록에는 이름·키 앞자리·권한·마지막 사용 시각·상태가 보입니다. 발급일과 만료일(있는 경우)은 이름 아래에 표시됩니다.
• 폐기를 누르면 즉시 무효가 됩니다. 이 키로 오던 요청은 그 순간부터 모두 실패하므로, 먼저 새 키로 교체한 뒤 폐기하세요. 폐기한 키는 되살릴 수 없습니다.

한도와 제한

• 키 개수에는 제한이 없습니다(2026-09-17 요금제 개편).
• 키 하나당 초당 5회까지 호출할 수 있습니다. 넘으면 429 RATE_LIMITED 와 Retry-After 초가 돌아옵니다. 월간 호출 수는 플랜 한도(429 PLAN_LIMIT)를 따릅니다. 앱 토큰(크롬 확장 등 앱이 쓰는 토큰)은 월간 호출 수를 세지 않는 대신 플랜 등급에 따라 초당 속도가 다릅니다(FREE 5회 · STARTER 10회 · PRO 25회).
• 호출 기록은 API 로그 메뉴에서 봅니다.