Update README.md · converspace/webmention@3c19e8f (original) (raw)

1

``

`-

webmention-specification

`

2

``

`-

========================

`

``

1

`+

WebMention Specification

`

``

2

+

``

3

`+

A modern alternative to Pingback.

`

``

4

+

``

5

+

``

6

`+

Protocol Flow

`

``

7

+

``

8

`+

Sender discovers Receiver Endpoint

`

``

9

+

``

10


```

``

11

`+

GET /bob/post/2 HTTP/1.1

`

``

12

`+

Host: bobs.host

`

``

13

+

``

14

+

``

15

`+

< HTTP/1.1 200 OK

`

``

16

`+

< Link: http://bobs.host/webmention-endpoint; rel="http://webmention.org/"

`

``

17

`+

< ...

`

``

18

`+

<

`

``

19

`+

<

`

``

20

`+

< ...

`

``

21

`+

<

`

``

22

`+

< ...

`

``

23


```

``

24

+

``

25

+

``

26

+

``

27

+

``

28

`+

Sender Notifies Receiver

`

``

29

+

``

30


```

``

31

`+

POST /webmention-endpoint HTTP/1.1

`

``

32

`+

Host: bobs.host

`

``

33

`+

Content-Type: application/x-www-url-form-encoded

`

``

34

`+

`

``

35

`+

source=http://alices.host/alice/post/42&\

`

``

36

`+

target=http://bobs.host/bob/post/2

`

``

37


```

``

38

+

``

39

`+

Note: the "" character is used here to indicate line wrapping in the request content and is not part of the content itself.

`

``

40

+

``

41

`` +

bobs.host should check that target is a valid resource belonging to it and then perform a GET on source and confirm that it actually links to target.

``

``

42

+

``

43

+

``

44

`+

See also

`

``

45

+

``

46

`+

`

``

47

`+

`

``

48

`+

`

``

49

`+

`

``

50

+

``

51

`+

Let's collaborate

`

``

52

`+

Feel free to file an issue if you have feedback/questions/suggestions.

`