Update admin/domain_blocks to include conflict response (#1417)

* 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
This commit is contained in:
Emelia Smith 2024-05-07 19:54:14 +02:00 committed by GitHub
parent 59c5876836
commit 5f0bd3cb77
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 40 additions and 6 deletions

View File

@ -22,6 +22,7 @@ aliases: [
{ {
"id": "1", "id": "1",
"domain": "example.com", "domain": "example.com",
"digest": "a379a6f6eeafb9a55e378c118034e2751e682fab9f2d30ab13d2125586ce1947",
"created_at": "2022-11-16T08:15:34.238Z", "created_at": "2022-11-16T08:15:34.238Z",
"severity": "noop", "severity": "noop",
"reject_media": false, "reject_media": false,
@ -48,6 +49,13 @@ aliases: [
**Version history:**\ **Version history:**\
4.0.0 - added 4.0.0 - added
### `digest` {#digest}
**Description:** The sha256 hex digest of the domain that is not allowed to federated.\
**Type:** String\
**Version history:**\
4.3.0 - added
### `created_at` {#created_at} ### `created_at` {#created_at}
**Description:** When the domain was blocked from federating.\ **Description:** When the domain was blocked from federating.\

View File

@ -60,6 +60,7 @@ limit
{ {
"id": "1", "id": "1",
"domain": "example.com", "domain": "example.com",
"digest": "a379a6f6eeafb9a55e378c118034e2751e682fab9f2d30ab13d2125586ce1947",
"created_at": "2022-11-16T08:15:34.238Z", "created_at": "2022-11-16T08:15:34.238Z",
"severity": "noop", "severity": "noop",
"reject_media": false, "reject_media": false,
@ -120,6 +121,7 @@ Authorization
{ {
"id": "1", "id": "1",
"domain": "example.com", "domain": "example.com",
"digest": "a379a6f6eeafb9a55e378c118034e2751e682fab9f2d30ab13d2125586ce1947",
"created_at": "2022-11-16T08:15:34.238Z", "created_at": "2022-11-16T08:15:34.238Z",
"severity": "noop", "severity": "noop",
"reject_media": false, "reject_media": false,
@ -205,6 +207,7 @@ Domain has been blocked from federating.
{ {
"id": "1", "id": "1",
"domain": "example.com", "domain": "example.com",
"digest": "a379a6f6eeafb9a55e378c118034e2751e682fab9f2d30ab13d2125586ce1947",
"created_at": "2022-11-16T08:15:34.238Z", "created_at": "2022-11-16T08:15:34.238Z",
"severity": "noop", "severity": "noop",
"reject_media": false, "reject_media": false,
@ -225,7 +228,7 @@ Authorized user is not allowed to perform this action, or invalid or missing Aut
} }
``` ```
##### 422: Unprocessable entity ##### 422: Unprocessable entity - Missing Parameter
The domain parameter was not provided The domain parameter was not provided
@ -235,6 +238,28 @@ The domain parameter was not provided
} }
``` ```
##### 422: Unprocessable entity - Existing Domain Block
The domain parameter already is covered by an existing domain block.
```json
{
"error": "You have already imposed stricter limits on example.com."
"existing_domain_block": {
"id": "1",
"domain": "example.com",
"digest": "a379a6f6eeafb9a55e378c118034e2751e682fab9f2d30ab13d2125586ce1947",
"created_at": "2022-11-16T08:15:34.238Z",
"severity": "noop",
"reject_media": false,
"reject_reports": false,
"private_comment": null,
"public_comment": null,
"obfuscate": false
}
}
```
--- ---
## Update a domain block {#update} ## Update a domain block {#update}
@ -292,6 +317,7 @@ Domain block has been updated
{ {
"id": "1", "id": "1",
"domain": "example.com", "domain": "example.com",
"digest": "a379a6f6eeafb9a55e378c118034e2751e682fab9f2d30ab13d2125586ce1947",
"created_at": "2022-11-16T08:15:34.238Z", "created_at": "2022-11-16T08:15:34.238Z",
"severity": "noop", "severity": "noop",
"reject_media": false, "reject_media": false,