geodeck
← 모든 문서

CMS 즉시 업데이트

이 선택적 서명 POST endpoint 를 사용하면 콘텐츠 변경 후 몇 분 안에 geodeck 가 llms.txt, Markdown Mirror, sitemap 신호, 관련 검색 업데이트를 반영합니다. 즉시 업데이트가 필요 없더라도 호스팅된 SEO / GEO 파일과 감사는 여전히 유용합니다.

엔드포인트

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 – 서명 누락/유효하지 않음.
  • 401 Unauthorized – 알 수 없는 도메인.
  • 402 Payment Required – 플랜 요청 한도 도달.

재시도

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

더 읽을 수 있는 것은?

geodeck 문서를 계속 읽거나 플랫폼 페이지로 이동하세요.

Platform