telegraph.md

Telegraph

Implementation Home Page URL: https://telegraph.p3k.io

Source Code repo URL(s) (optional): https://github.com/aaronpk/Telegraph

• 100% open source implementation

Programming Language(s): PHP

Developer(s): Aaron Parecki

Implementation Classes (Sender and/or Receiver): Sender

Sending

Discovery Tests (3.1.1)

MUST

• Discovery Test #1
• Discovery Test #2
• Discovery Test #3
• Discovery Test #4
• Discovery Test #5
• Discovery Test #6
• Discovery Test #7
• Discovery Test #8
• Discovery Test #9
• Discovery Test #10
• Discovery Test #11
• Discovery Test #12
• Discovery Test #13
• Discovery Test #14
• Discovery Test #15
• Discovery Test #16
• Discovery Test #17
• Discovery Test #18
• Discovery Test #19
• Discovery Test #20
• Discovery Test #21

Sending Tests (3.1.2)

MUST

• Accepts HTTP 200 response as a success
• Accepts HTTP 201 response as a success
• Accepts HTTP 202 response as a success

Update Tests (3.1.3)

SHOULD

• Update Test #1
• Update Test #2

Implementation Notes

Since Telegraph is an API, it depends on the calling website to update the post contents and trigger sending Webmentions when the post is updated.

Delete Test (3.1.4)

SHOULD

• Delete Test #1

Security Considerations (4)

• The sender avoids sending a Webmention to a loopback address (SHOULD)

Extensions

This implementation has also implemented the following extensions.

• Salmention
• Vouch
• Private Webmention
• Telegraph will pass on an authorization code when sending a Webmention, but of course does not have the ability to generate codes for arbitrary websites itself.