geodeck
← 모든 문서

CMS Webhook

게시/게시 취소 시 geodeck에 알려 llms.txt 재생성 및 다운스트림 ping을 트리거합니다.

엔드포인트

POST https://geodeck.icu/api/webhook/cms
X-geodeck-Signature: sha256=<hex hmac of raw body>
Content-Type: application/json

페이로드

{
  "domain": "example.com",
  "url":    "https://example.com/blog/post-slug",
  "event":  "publish"
}

event는 publish, update 또는 unpublish 중 하나여야 합니다.

Batch submission

{
  "domain": "example.com",
  "urls": [
    "https://example.com/blog/post-one",
    "https://example.com/blog/post-two"
  ],
  "event": "update"
}

Batch mode accepts up to 500 same-host URLs per signed request. In batch mode, omit title, summary, content, and html.

서명

도메인의 Webhook 시크릿을 사용하여 요청 본문 raw의 HMAC-SHA256을 계산합니다. sha256= 접두사와 함께 16진수 인코딩으로 전송합니다.

echo -n "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex

응답

  • 202 Accepted - 페이로드 큐에 추가됨.
  • 401 Unauthorized - 서명 누락/유효하지 않음.
  • 404 - 알 수 없는 도메인.
  • 429 - 플랜 요청 한도 도달.

재시도

5xx 응답 시 지수 백오프(1초, 5초, 30초, 5분)로 재시도합니다. 세 번째 실패 후 CMS 로그에 오류를 표시합니다.

What else can I read?

Keep reading the rest of the Geodeck documentation, or jump to the platform pages.

Platform