mirror of
https://github.com/mastodon/documentation
synced 2025-04-11 22:56:17 +02:00
bcf77cb795
* add identifier for troubleshooting pages * mention mutes can be temporary now * bell for notifications * convert images to jpg and rename them * suspensions now reversible * unread notifications * suspended: true * mutes expiry * replies_policy, type of notification * notify * featuredTags AP representation * new env vars * accounts merge * maintenance cli * list replies * suspended flag * follower sync * minor formatting * add note about idempotency of follow action * account featured tags, min_id and max_id, plus normalization * follow marcin and nightpool's suggestion * bearcaps * replies_policy update * featuredtags now have a url
951 B
951 B
| title | description | menu | ||||||
|---|---|---|---|---|---|---|---|---|
| Bearcaps | A URI scheme combining URLs with a Bearer token needed to access them. |
|
What are bearcaps?
In certain cases, resources may not be publically available and may require a token to successfully fetch them. This is typically done by using an HTTP Authorization header containing a Bearer token, like so:
GET https://example.com/foo
Authorization: Bearer <token>
Bearcaps allow for a way to link to a resource with the token included, like so:
bear:?t=<token>&u=https://example.com/foo'
To translate a bearcap to an HTTP request, simply make a request to the u parameter and attach the t parameter as a Bearer token in the Authorization header.
How are bearcaps used in Mastodon?
As of v3.3.0, Mastodon supports dereferencing bearcaps in a received Activity. Bearcap are not used for sending any Activity yet.