소스 검색

Add docstring to webmention:status endpoint

tags/v1.9.7
Danielle McLean 2 년 전
부모
커밋
e5bad72e36
로그인 계정: 00dani GPG 키 ID: 8EB789DDF3ABD240
1개의 변경된 파일20개의 추가작업 그리고 1개의 파일을 삭제
  1. +20
    -1
      webmention/views.py

+ 20
- 1
webmention/views.py 파일 보기

@@ -62,6 +62,25 @@ def accept(request):


@require_GET
def status(request, mention_id):
def status(mention_id):
"""
Retrieve the verification status of the specified webmention.

A webmention is accepted synchronously by the target site (me, in this
case) and then must be verified asynchronously - this means contacting the
source URL and confirming that it really does link to the target URL it
claimed to. Until this verification is complete, we can't assume the
mention is real and shouldn't display it anywhere.

Therefore, when a webmention is accepted, we return a Location header
pointing to this endpoint. The source site may, if desired, use this
endpoint to check whether their webmention has been verified or not.

The status is currently returned as a plain string, e.g., 'pending'.
However, eventually this will use a nice template instead, possibly
displaying additional information about the mention. There's no
standardised format for the status response, and most implementations
currently use a friendly human-readable format, so I'll be doing the same.
"""
mention = get_object_or_404(Webmention.objects, pk=mention_id)
return HttpResponse(mention.get_state_display())

불러오는 중...
취소
저장