Add a new document that precisely describes the string representation of
datetime and date types.
The previous description of them as "ISO 8601 Datetime" was very
imprecise, as ISO 8601 describes many different ways of representing a
datetime and date.
Specify the datetime format precisely as the ISO 8601 profile described
in RFC 3339, and the date format precisely as the "Complete date" format
from the W3C note on date and time formats.
Adjust all the references to ISO 8601 datetimes or dates to link back
to the definition.
Fixes#1420
* Improve deprecation messaging for Application#vapid_key
* Format JSON examples in Instance methods
* Remove vapid_key from Apps API examples, since this property is deprecated on Application entity
* Add documentation for new OAuth 2.0 features added in 4.3.0
* Improve documentation for oauth-scopes
* Update content/en/api/oauth-scopes.md
Co-authored-by: Matt Jankowski <matt@jankowski.online>
* Update content/en/api/oauth-scopes.md
Co-authored-by: Matt Jankowski <matt@jankowski.online>
* Update content/en/api/oauth-scopes.md
Co-authored-by: Matt Jankowski <matt@jankowski.online>
* Update content/en/api/oauth-scopes.md
Co-authored-by: Matt Jankowski <matt@jankowski.online>
* Add deprecated and removed shortcode labels
* Use deprecated and removed shortcodes
* Improve OAuth documentation
* More OAuth documentation improvements
* Correct streaming API documentation after 4.2.0 changes
* Add note about improved Push Subscription API validation in 4.3.0
* Fix inconsistent OAuth label formatting
* Add note that there is a relationship between Accounts and the Application used to create them
* Add note that application registration endpoint also supports JSON bodies
* Be consistent in the formatting of placeholder values for Bearer tokens
* code review changes
* Slight changes in wording
* Add documentation for PKCE
* Removal of crypto oauth scope
* Cross-link authorization's scope with the OAuth Scopes documentation
* Update content/en/methods/oauth.md
* Update content/en/api/oauth-scopes.md
---------
Co-authored-by: Matt Jankowski <matt@jankowski.online>
Co-authored-by: David Roetzel <david@roetzel.de>
* Clarify `group_key` for ungrouped notifications
* Clarify that `grouped_types` affects `group_key` but not streaming API
* Update content/en/methods/grouped_notifications.md
Co-authored-by: Claire <claire.github-309c@sitedethib.com>
---------
Co-authored-by: David Roetzel <david@roetzel.de>
* Add rough documentation for `/api/v2_alpha/notifications`
* Update notifications_alpha.md
* Add very rough documentation about notification groups entities
* Add documentation for `NotificationGroup` entity
* Document pagination-only `NotificationGroup` attributes
* Fix documentation issue with `/api/v2_alpha/notifications/:group_key` and add example output
* Add blurb about the goal of grouped notifications
* Update notifications_alpha.md
* Specify that the 80 limit is for notification groups, not notifications
* Add documentation for `group_key` to `Notification` entity
* Make `max_id`, `since_id` and `min_id` more explicit
* Mark MediaAttachment.preview_url as nullable
Had a payload in the wild where preview_url was `null` and the method that generates this value can certainly return `nil` if none of its conditions are met: d326ad0ed9/app/serializers/rest/media_attachment_serializer.rb (L30-L38)
Also both TootSDK and IceCubesApp have this property as nullable.
* Mark MediaAttachment.blurhash as nullable
When the attachment has type `audio`, `blurhash` is `null`.
* Add documentation for GET /api/v1/notifications/policy
* Add documentation for `PATCH /api/v1/notifications/policy`
* Add documentation for `GET /api/v1/notifications/requests`
* Add documentation for `GET /api/v1/notifications/requests/:id`
* Add documentation for accepting and rejecting requests
* Remove redundant HTTP request examples
* Add documentation for the `NotificationPolicy` entity
* Add documentation for the `NotificationRequest` entity
* Update admin/domain_blocks to include conflict response
When creating a domain block, if there is already a domain block rule for the domain, then the existing block is returned. This documents that behavior.
I've also documented the `digest` property which was added in https://github.com/mastodon/mastodon/pull/29092
* Document digest in Admin DomainBlock Entity
* Fix docs of the Translation entity
The poll attribute is an object, not an array.
* Update Translation.md
* add more information about the atachment and poll option types
* fixed invalid json examples
* correct type: integer for a count, not number
* correct type: array of string, not string
* add square brackets around entity return type
* added missing path parameter definition
* spacing fix
* PR comment: add link
* fix relrefs around trends and related entities
* revert moving caption-links to middle of page
* hide empty menu in table of contents
* clarify edit notifs are only for boosted statuses
* following/followers no longer need auth
* fix typo
* specify cooldown period for account Move
* use the correct cooldown
* add missing parameters to accounts/id/statuses
* link to account_statuses_filter.rb
* fix typo (#1072)
* fix typo (#1073)
* fix link to http sig spec (#1067)
* simply HTTP request examples in api methods docs
* add missing client_secret to oauth/token (#1062)
* Add any, all, none to hashtag timeline
* minor formatting changes
* Update signature requirements and advice
* fix public key -> private key
* clarify use of RSA with SHA256
* Add note about saving your profile after adding rel-me link
* v2 filters api
* comment out params that shouldn't be used in v2 filter api
* admin trends
* remove old todo
* canonical email blocks + scheduled statuses
* remove under-construction warnings from finished pages
* verify api method params with source code
* fix typo (#1088)
* fix broken caption-links (#1100)
* fix formatting of entities (#1094)
* Remove keybase section from user guide (#1093)
* fix typos (#1092)
* Verify limits are accurate (#1086)
* add mention of iframe limitation (#1084)
* Add CORS header to WEB_DOMAIN example (#1083)
* Fix typo (#1081)
* pin http sigs spec at draft 8
* Revert "pin http sigs spec at draft 8"
This reverts commit 9fd5f7032b69b29e77599dd62adfe8d2f5cd4f20.
* add case sensitivity warning to 4.0 roles
* Add url length note to bio (#1087)
* remove follow scope from examples (#1103)
* clarify usage of update_credentials to update profile fields
* add noindex to Account entitity
* remove required hint from technically not required property
