CMS 즉시 업데이트

엔드포인트

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 로그에 오류를 표시합니다.

이것은 IndexNow 및 Google 표준과 어떻게 비교되나요?

geodeck 자체의 배치 상한은 더 넓은 생태계보다 작습니다. IndexNow 문서는 요청당 훨씬 더 큰 배치를 허용하며, IndexNow 프로토콜 아래에서 한 검색 엔진이 핑을 받으면 참여 중인 다른 모든 엔진에 자동으로 공유됩니다. Google의 AI 기능 공식 문서는 Google의 AI 기능에 별도의 webhook이나 파일 형식이 필요하지 않다고 확인하며, Search Console sitemap 도움말은 이 endpoint가 단축하려는 즉시성이 없는 동등한 경로를 다룹니다.

한 번의 게시로 최대 10,000개의 URL을 제출할 수 있으며, 필요하다면 http와 https URL을 혼합할 수 있습니다.

— IndexNow documentation

IndexNow 프로토콜을 채택한 검색 엔진들은 제출된 URL이 참여 중인 다른 모든 검색 엔진과 자동으로 공유되는 데 동의합니다.

— IndexNow documentation

성공적인 요청은 HTTP 200 응답 코드를 반환합니다. 다른 응답을 받았다면 너무 자주 제출하지 않았는지, 키와 URL이 유효한지 확인한 후 요청을 다시 제출하세요.

— IndexNow documentation