웹훅

웹훅은 하나 이상의 테이블에서 발생한 이벤트를 HTTPS 주소로 보냅니다. 이벤트는 record.created, record.updated, record.deleted입니다. 웹훅은 데이터베이스 메뉴의 API 및 에이전트 아래에 있는 웹훅… 에서 관리합니다.

페이로드

본문은 항상 이벤트 배열이며, 각 이벤트에는 변경 전과 변경 후의 전체 행, 그리고 바뀐 필드 목록이 들어 있습니다.

{ "events": [
  { "id": "0195e…", "type": "record.updated",
    "occurred_at": "2026-09-26T14:03:00.120Z",
    "tenant": "t4z56fq", "base": "b_t4z56fq_ventes", "table": "opportunites",
    "record_id": "0195a…",
    "actor": { "kind": "user" },
    "before": { "statut": "negociation", "montant": "125000", … },
    "after":  { "statut": "gagne", "montant": "125000", … },
    "changed": ["statut"] } ] }

SQL로 직접 쓴 경우에도 이벤트가 발생합니다. 이벤트는 트리거가 기록한 기록에서 출발하기 때문입니다.

서명, 순서, 재시도

• 서명: X-Basedb-Signature: t=…,v1=…. 원본 본문의 HMAC-SHA256이며, 역직렬화하기 전에 검증해야 합니다.
• 행 단위로 순서 보장: 같은 행의 두 이벤트는 순서대로 도착합니다.
• 실패하면 재시도합니다. 재시도 한도를 넘으면 웹훅이 비활성화되며, 인터페이스에서 다시 활성화할 수 있습니다. 대기열과 각 전송 내역을 확인하고, 다시 보내거나 포기할 수 있습니다.
• 최소 한 번 전송: X-Basedb-Delivery-Id 또는 events[].id로 중복을 제거하세요.

대상

웹훅은 공개 HTTPS 주소로만 전송됩니다. 개발 환경에서는 BASEDB_WEBHOOK_DEV=1을 설정하면 HTTP와 로컬 주소도 허용됩니다.

여러분의 네트워크에 있는 서버는 인스턴스 운영자가 BASEDB_WEBHOOK_ALLOW에 등록합니다 — 이름, 도메인(*.intra.example.com), 주소 또는 범위(10.12.0.0/16):

BASEDB_WEBHOOK_ALLOW=chat.intra.example.com,10.12.0.0/16

이 대상들은 주소, 포트, 스킴에 관계없이 — HTTP를 포함해 — 허용됩니다. 이 목록은 자동화의 HTTP 요청과 동기화된 테이블의 소스에도 적용되며, 인터페이스가 아니라 환경에서만 설정합니다.

웹훅 없이 테이블 추적하기

접속을 받을 수 없는 서버도 basedb에 직접 연결해서 데이터베이스의 연동 토큰으로 실시간 스트림을 통해 테이블을 추적할 수 있습니다:

curl -N "https://basedb.example.com/api/v1/t4z56fq/events?base=b_t4z56fq_ventes&table=opportunites" \
  -H "Authorization: Bearer $BASEDB_TOKEN"

이 스트림(text/event-stream)은 신호만 전달합니다 — 생성, 수정, 삭제된 행의 식별자가 담긴 records 이벤트이며, 값은 절대 담지 않습니다: 프로그램은 이 행들을 REST API로 다시 읽습니다. 토큰이 철회되면 20초 안에 스트림이 닫힙니다. 드물게 읽는 테이블이라면 가끔 바뀐 행을 다시 읽는 것으로 충분합니다: filter=_updated_at gt "2026-09-30T08:00:00Z".