Documentation
¶
Index ¶
- Constants
- type Module
- func (m *Module) AccountActionPOSTHandler(c *gin.Context)
- func (m *Module) DomainBlockDELETEHandler(c *gin.Context)
- func (m *Module) DomainBlockGETHandler(c *gin.Context)
- func (m *Module) DomainBlocksGETHandler(c *gin.Context)
- func (m *Module) DomainBlocksPOSTHandler(c *gin.Context)
- func (m *Module) EmailTestPOSTHandler(c *gin.Context)
- func (m *Module) EmojiCategoriesGETHandler(c *gin.Context)
- func (m *Module) EmojiCreatePOSTHandler(c *gin.Context)
- func (m *Module) EmojiDELETEHandler(c *gin.Context)
- func (m *Module) EmojiGETHandler(c *gin.Context)
- func (m *Module) EmojiPATCHHandler(c *gin.Context)
- func (m *Module) EmojisGETHandler(c *gin.Context)
- func (m *Module) MediaCleanupPOSTHandler(c *gin.Context)
- func (m *Module) MediaRefetchPOSTHandler(c *gin.Context)
- func (m *Module) ReportGETHandler(c *gin.Context)
- func (m *Module) ReportResolvePOSTHandler(c *gin.Context)
- func (m *Module) ReportsGETHandler(c *gin.Context)
- func (m *Module) Route(...)
Constants ¶
const ( BasePath = "/v1/admin" EmojiPath = BasePath + "/custom_emojis" EmojiPathWithID = EmojiPath + "/:" + IDKey EmojiCategoriesPath = EmojiPath + "/categories" DomainBlocksPath = BasePath + "/domain_blocks" DomainBlocksPathWithID = DomainBlocksPath + "/:" + IDKey AccountsPath = BasePath + "/accounts" AccountsPathWithID = AccountsPath + "/:" + IDKey AccountsActionPath = AccountsPathWithID + "/action" MediaCleanupPath = BasePath + "/media_cleanup" MediaRefetchPath = BasePath + "/media_refetch" ReportsPath = BasePath + "/reports" ReportsPathWithID = ReportsPath + "/:" + IDKey ReportsResolvePath = ReportsPathWithID + "/resolve" EmailPath = BasePath + "/email" EmailTestPath = EmailPath + "/test" IDKey = "id" FilterQueryKey = "filter" MaxShortcodeDomainKey = "max_shortcode_domain" MinShortcodeDomainKey = "min_shortcode_domain" LimitKey = "limit" DomainQueryKey = "domain" ResolvedKey = "resolved" AccountIDKey = "account_id" TargetAccountIDKey = "target_account_id" MaxIDKey = "max_id" SinceIDKey = "since_id" MinIDKey = "min_id" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Module ¶
type Module struct {
// contains filtered or unexported fields
}
func New ¶
func New(processor *processing.Processor) *Module
func (*Module) AccountActionPOSTHandler ¶ added in v0.2.2
AccountActionPOSTHandler swagger:operation POST /api/v1/admin/accounts/{id}/action adminAccountAction
Perform an admin action on an account.
--- tags: - admin consumes: - multipart/form-data produces: - application/json parameters: - name: id required: true in: path description: ID of the account. type: string - name: type in: formData description: Type of action to be taken, currently only supports `suspend`. type: string required: true - name: text in: formData description: Optional text describing why this action was taken. type: string security: - OAuth2 Bearer: - admin responses: '200': description: OK '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) DomainBlockDELETEHandler ¶
DomainBlockDELETEHandler swagger:operation DELETE /api/v1/admin/domain_blocks/{id} domainBlockDelete
Delete domain block with the given ID.
--- tags: - admin produces: - application/json parameters: - name: id type: string description: The id of the domain block. in: path required: true security: - OAuth2 Bearer: - admin responses: '200': description: The domain block that was just deleted. schema: "$ref": "#/definitions/domainBlock" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) DomainBlockGETHandler ¶
DomainBlockGETHandler swagger:operation GET /api/v1/admin/domain_blocks/{id} domainBlockGet
View domain block with the given ID.
--- tags: - admin produces: - application/json parameters: - name: id type: string description: The id of the domain block. in: path required: true security: - OAuth2 Bearer: - admin responses: '200': description: The requested domain block. schema: "$ref": "#/definitions/domainBlock" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) DomainBlocksGETHandler ¶
DomainBlocksGETHandler swagger:operation GET /api/v1/admin/domain_blocks domainBlocksGet
View all domain blocks currently in place.
--- tags: - admin produces: - application/json parameters: - name: export type: boolean description: >- If set to `true`, then each entry in the returned list of domain blocks will only consist of the fields `domain` and `public_comment`. This is perfect for when you want to save and share a list of all the domains you have blocked on your instance, so that someone else can easily import them, but you don't want them to see the database IDs of your blocks, or private comments etc. in: query required: false security: - OAuth2 Bearer: - admin responses: '200': description: All domain blocks currently in place. schema: type: array items: "$ref": "#/definitions/domainBlock" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) DomainBlocksPOSTHandler ¶
DomainBlocksPOSTHandler swagger:operation POST /api/v1/admin/domain_blocks domainBlockCreate
Create one or more domain blocks, from a string or a file.
You have two options when using this endpoint: either you can set `import` to `true` and upload a file containing multiple domain blocks, JSON-formatted, or you can leave import as `false`, and just add one domain block.
The format of the json file should be something like: `[{"domain":"example.org"},{"domain":"whatever.com","public_comment":"they smell"}]`
--- tags: - admin consumes: - multipart/form-data produces: - application/json parameters: - name: import in: query description: >- Signal that a list of domain blocks is being imported as a file. If set to `true`, then 'domains' must be present as a JSON-formatted file. If set to `false`, then `domains` will be ignored, and `domain` must be present. type: boolean default: false - name: domains in: formData description: >- JSON-formatted list of domain blocks to import. This is only used if `import` is set to `true`. type: file - name: domain in: formData description: >- Single domain to block. Used only if `import` is not `true`. type: string - name: obfuscate in: formData description: >- Obfuscate the name of the domain when serving it publicly. Eg., `example.org` becomes something like `ex***e.org`. Used only if `import` is not `true`. type: boolean - name: public_comment in: formData description: >- Public comment about this domain block. This will be displayed alongside the domain block if you choose to share blocks. Used only if `import` is not `true`. type: string - name: private_comment in: formData description: >- Private comment about this domain block. Will only be shown to other admins, so this is a useful way of internally keeping track of why a certain domain ended up blocked. Used only if `import` is not `true`. type: string security: - OAuth2 Bearer: - admin responses: '200': description: >- The newly created domain block, if `import` != `true`. If a list has been imported, then an `array` of newly created domain blocks will be returned instead. schema: "$ref": "#/definitions/domainBlock" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) EmailTestPOSTHandler ¶ added in v0.8.0
EmailTestPostHandler swagger:operation POST /api/v1/admin/email/test testEmailSend
Send a generic test email to a specified email address.
This can be used to validate an instance's SMTP configuration, and to debug any potential issues.
If an error is returned by the SMTP connection, this handler will return code 422 to indicate that the request could not be processed, and the SMTP error will be returned to the caller.
--- tags: - admin consumes: - multipart/form-data produces: - application/json parameters: - name: email in: formData description: The email address that the test email should be sent to. type: string security: - OAuth2 Bearer: - admin responses: '202': description: Test email was sent. '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '422': description: >- An smtp occurred while the email attempt was in progress. Check the returned json for more information. The smtp error will be included, to help you debug communication with the smtp server. '500': description: internal server error
func (*Module) EmojiCategoriesGETHandler ¶ added in v0.6.0
EmojiCategoriesGETHandler swagger:operation GET /api/v1/admin/custom_emojis/categories emojiCategoriesGet
Get a list of existing emoji categories.
--- tags: - admin produces: - application/json parameters: - name: id type: string description: The id of the emoji. in: path required: true responses: '200': description: Array of existing emoji categories. schema: type: array items: "$ref": "#/definitions/adminEmojiCategory" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) EmojiCreatePOSTHandler ¶ added in v0.2.0
EmojiCreatePOSTHandler swagger:operation POST /api/v1/admin/custom_emojis emojiCreate
Upload and create a new instance emoji.
---
tags:
- admin
consumes:
- multipart/form-data
produces:
- application/json
parameters:
-
name: shortcode
in: formData
description: >-
The code to use for the emoji, which will be used by instance denizens to select it.
This must be unique on the instance.
type: string
pattern: \w{2,30}
required: true
-
name: image
in: formData
description: >-
A png or gif image of the emoji. Animated pngs work too!
To ensure compatibility with other fedi implementations, emoji size limit is 50kb by default.
type: file
required: true
-
name: category
in: formData
description: >-
Category in which to place the new emoji. 64 characters or less.
If left blank, emoji will be uncategorized. If a category with the
given name doesn't exist yet, it will be created.
type: string
required: false
security:
- OAuth2 Bearer:
- admin
responses:
'200':
description: The newly-created emoji.
schema:
"$ref": "#/definitions/emoji"
'400':
description: bad request
'401':
description: unauthorized
'403':
description: forbidden
'404':
description: not found
'406':
description: not acceptable
'409':
description: conflict -- shortcode for this emoji is already in use
'500':
description: internal server error
func (*Module) EmojiDELETEHandler ¶ added in v0.6.0
EmojiDELETEHandler swagger:operation DELETE /api/v1/admin/custom_emojis/{id} emojiDelete
Delete a **local** emoji with the given ID from the instance.
Emoji with the given ID will no longer be available to use on the instance.
If you just want to update the emoji image instead, use the `/api/v1/admin/custom_emojis/{id}` PATCH route.
To disable emojis from **remote** instances, use the `/api/v1/admin/custom_emojis/{id}` PATCH route.
--- tags: - admin produces: - application/json parameters: - name: id type: string description: The id of the emoji. in: path required: true security: - OAuth2 Bearer: - admin responses: '200': description: The deleted emoji will be returned to the caller in case further processing is necessary. schema: "$ref": "#/definitions/adminEmoji" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) EmojiGETHandler ¶ added in v0.6.0
EmojiGETHandler swagger:operation GET /api/v1/admin/custom_emojis/{id} emojiGet
Get the admin view of a single emoji.
--- tags: - admin produces: - application/json parameters: - name: id type: string description: The id of the emoji. in: path required: true responses: '200': description: A single emoji. schema: "$ref": "#/definitions/adminEmoji" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) EmojiPATCHHandler ¶ added in v0.6.0
EmojiPATCHHandler swagger:operation PATCH /api/v1/admin/custom_emojis/{id} emojiUpdate
Perform admin action on a local or remote emoji known to this instance.
Action performed depends upon the action `type` provided.
`disable`: disable a REMOTE emoji from being used/displayed on this instance. Does not work for local emojis.
`copy`: copy a REMOTE emoji to this instance. When doing this action, a shortcode MUST be provided, and it must be unique among emojis already present on this instance. A category MAY be provided, and the copied emoji will then be put into the provided category.
`modify`: modify a LOCAL emoji. You can provide a new image for the emoji and/or update the category.
Local emojis cannot be deleted using this endpoint. To delete a local emoji, check DELETE /api/v1/admin/custom_emojis/{id} instead.
---
tags:
- admin
consumes:
- multipart/form-data
produces:
- application/json
parameters:
-
name: id
type: string
description: The id of the emoji.
in: path
required: true
-
name: type
in: formData
description: |-
Type of action to be taken. One of: (`disable`, `copy`, `modify`).
For REMOTE emojis, `copy` or `disable` are supported.
For LOCAL emojis, only `modify` is supported.
type: string
required: true
-
name: shortcode
in: formData
description: >-
The code to use for the emoji, which will be used by instance denizens to select it.
This must be unique on the instance. Works for the `copy` action type only.
type: string
pattern: \w{2,30}
-
name: image
in: formData
description: >-
A new png or gif image to use for the emoji. Animated pngs work too!
To ensure compatibility with other fedi implementations, emoji size limit is 50kb by default.
Works for LOCAL emojis only.
type: file
-
name: category
in: formData
description: >-
Category in which to place the emoji. 64 characters or less.
If a category with the given name doesn't exist yet, it will be created.
type: string
security:
- OAuth2 Bearer:
- admin
responses:
'200':
description: The updated emoji.
schema:
"$ref": "#/definitions/adminEmoji"
'400':
description: bad request
'401':
description: unauthorized
'403':
description: forbidden
'404':
description: not found
'406':
description: not acceptable
'500':
description: internal server error
func (*Module) EmojisGETHandler ¶ added in v0.6.0
EmojisGETHandler swagger:operation GET /api/v1/admin/custom_emojis emojisGet
View local and remote emojis available to / known by this instance.
The next and previous queries can be parsed from the returned Link header. Example:
`<http://localhost:8080/api/v1/admin/custom_emojis?limit=30&max_shortcode_domain=yell@fossbros-anonymous.io&filter=domain:all>; rel="next", <http://localhost:8080/api/v1/admin/custom_emojis?limit=30&min_shortcode_domain=rainbow@&filter=domain:all>; rel="prev"`
--- tags: - admin produces: - application/json parameters: - name: filter type: string description: |- Comma-separated list of filters to apply to results. Recognized filters are: `domain:[domain]` -- show emojis from the given domain, eg `?filter=domain:example.org` will show emojis from `example.org` only. Instead of giving a specific domain, you can also give either one of the key words `local` or `all` to show either local emojis only (`domain:local`) or show all emojis from all domains (`domain:all`). Note: `domain:*` is equivalent to `domain:all` (including local). If no domain filter is provided, `domain:all` will be assumed. `disabled` -- include emojis that have been disabled. `enabled` -- include emojis that are enabled. `shortcode:[shortcode]` -- show only emojis with the given shortcode, eg `?filter=shortcode:blob_cat_uwu` will show only emojis with the shortcode `blob_cat_uwu` (case sensitive). If neither `disabled` or `enabled` are provided, both disabled and enabled emojis will be shown. If no filter query string is provided, the default `domain:all` will be used, which will show all emojis from all domains. in: query required: false default: "domain:all" - name: limit type: integer description: Number of emojis to return. Less than 1, or not set, means unlimited (all emojis). default: 50 in: query - name: max_shortcode_domain type: string description: >- Return only emojis with `[shortcode]@[domain]` *LOWER* (alphabetically) than given `[shortcode]@[domain]`. For example, if `max_shortcode_domain=beep@example.org`, then returned values might include emojis with `[shortcode]@[domain]`s like `car@example.org`, `debian@aaa.com`, `test@` (local emoji), etc. Emoji with the given `[shortcode]@[domain]` will not be included in the result set. in: query - name: min_shortcode_domain type: string description: >- Return only emojis with `[shortcode]@[domain]` *HIGHER* (alphabetically) than given `[shortcode]@[domain]`. For example, if `max_shortcode_domain=beep@example.org`, then returned values might include emojis with `[shortcode]@[domain]`s like `arse@test.com`, `0101_binary@hackers.net`, `bee@` (local emoji), etc. Emoji with the given `[shortcode]@[domain]` will not be included in the result set. in: query responses: '200': headers: Link: type: string description: Links to the next and previous queries. description: An array of emojis, arranged alphabetically by shortcode and domain. schema: type: array items: "$ref": "#/definitions/adminEmoji" '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) MediaCleanupPOSTHandler ¶ added in v0.3.4
MediaCleanupPOSTHandler swagger:operation POST /api/v1/admin/media_cleanup mediaCleanup
Clean up remote media older than the specified number of days.
Also cleans up unused headers + avatars from the media cache and prunes orphaned items from storage.
--- tags: - admin consumes: - application/json - application/xml - application/x-www-form-urlencoded produces: - application/json security: - OAuth2 Bearer: - admin responses: '200': description: >- Echos the number of days requested. The cleanup is performed asynchronously after the request completes. '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) MediaRefetchPOSTHandler ¶ added in v0.7.0
MediaRefetchPOSTHandler swagger:operation POST /api/v1/admin/media_refetch mediaRefetch
Refetch media specified in the database but missing from storage. Currently, this only includes remote emojis. This endpoint is useful when data loss has occurred, and you want to try to recover to a working state.
--- tags: - admin produces: - application/json security: - OAuth2 Bearer: - admin parameters: - name: domain in: query description: >- Domain to refetch media from. If empty, all domains will be refetched. type: string responses: '202': description: >- Request accepted and will be processed. Check the logs for progress / errors. '400': description: bad request '401': description: unauthorized '403': description: forbidden '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) ReportGETHandler ¶ added in v0.7.0
ReportGETHandler swagger:operation GET /api/v1/admin/reports/{id} adminReportGet
View user moderation report with the given id.
--- tags: - admin produces: - application/json parameters: - name: id type: string description: The id of the report. in: path required: true security: - OAuth2 Bearer: - admin responses: '200': name: report description: The requested report. schema: "$ref": "#/definitions/adminReport" '400': description: bad request '401': description: unauthorized '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) ReportResolvePOSTHandler ¶ added in v0.7.0
ReportResolvePOSTHandler swagger:operation POST /api/v1/admin/reports/{id}/resolve adminReportResolve
Mark a report as resolved.
--- tags: - admin consumes: - application/json - application/xml - multipart/form-data produces: - application/json parameters: - name: id type: string description: The id of the report. in: path required: true - name: action_taken_comment in: formData description: >- Optional admin comment on the action taken in response to this report. Useful for providing an explanation about what action was taken (if any) before the report was marked as resolved. This will be visible to the user that created the report! type: string example: The reported account was suspended. security: - OAuth2 Bearer: - admin responses: '200': name: report description: The resolved report. schema: "$ref": "#/definitions/adminReport" '400': description: bad request '401': description: unauthorized '404': description: not found '406': description: not acceptable '500': description: internal server error
func (*Module) ReportsGETHandler ¶ added in v0.7.0
ReportsGETHandler swagger:operation GET /api/v1/admin/reports adminReports
View user moderation reports.
The reports will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).
The next and previous queries can be parsed from the returned Link header.
Example:
``` <https://example.org/api/v1/admin/reports?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/admin/reports?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev" ````
--- tags: - admin produces: - application/json parameters: - name: resolved type: boolean description: >- If set to true, only resolved reports will be returned. If false, only unresolved reports will be returned. If unset, reports will not be filtered on their resolved status. in: query - name: account_id type: string description: Return only reports created by the given account id. in: query - name: target_account_id type: string description: Return only reports that target the given account id. in: query - name: max_id type: string description: >- Return only reports *OLDER* than the given max ID. The report with the specified ID will not be included in the response. in: query - name: since_id type: string description: >- Return only reports *NEWER* than the given since ID. The report with the specified ID will not be included in the response. This parameter is functionally equivalent to min_id. in: query - name: min_id type: string description: >- Return only reports *NEWER* than the given min ID. The report with the specified ID will not be included in the response. This parameter is functionally equivalent to since_id. in: query - name: limit type: integer description: >- Number of reports to return. If more than 100 or less than 1, will be clamped to 100. default: 20 in: query security: - OAuth2 Bearer: - admin responses: '200': name: reports description: Array of reports. schema: type: array items: "$ref": "#/definitions/adminReport" '400': description: bad request '401': description: unauthorized '404': description: not found '406': description: not acceptable '500': description: internal server error
Source Files