mirror of
https://github.com/navidrome/navidrome.git
synced 2026-10-08 02:17:25 +02:00
294c1a9a6a
Adds the seven auth operations to the spec (createAccessToken, listGrants, revokeGrant and logout in core; login, setupFirstAdmin and changePassword in the password module), the bearerAuth/grantAuth schemes, and vacuum rules requiring explicit security and a known x-scope. The strict handlers sit on core/apiauth and are covered end to end against a real SQLite database. The first operations with parameters make the generated code import github.com/oapi-codegen/runtime. An oapi-codegen overlay renames the shared offset/limit parameter types, since a generated Offset clashes with Ginkgo's dot-imported Offset in this package's tests; the published spec is unchanged.
44 lines
1.5 KiB
YAML
44 lines
1.5 KiB
YAML
type: object
|
|
description: RFC 9457 problem details, returned for every 4xx and 5xx response.
|
|
required: [title, status, code]
|
|
properties:
|
|
type:
|
|
type: string
|
|
description: |
|
|
URI reference identifying the problem type. Omitted while the problem carries no semantics
|
|
beyond its HTTP status code, which RFC 9457 defines as `about:blank`. Problems with their
|
|
own semantics get their own URI; switch on `code` instead.
|
|
title:
|
|
type: string
|
|
description: Short human-readable summary, the same for all occurrences of this problem type.
|
|
status:
|
|
type: integer
|
|
description: HTTP status code of this response.
|
|
detail:
|
|
type: string
|
|
description: Human-readable explanation specific to this occurrence. Omitted unless the server marked the text as safe to show clients.
|
|
code:
|
|
type: string
|
|
description: Machine-readable error code, and the value clients switch on. New codes may be added.
|
|
enum:
|
|
- validation
|
|
- unauthorized
|
|
- token_expired
|
|
- forbidden
|
|
- insufficient_scope
|
|
- not_found
|
|
- method_not_allowed
|
|
- setup_complete
|
|
- password_managed_externally
|
|
- payload_too_large
|
|
- rate_limited
|
|
- unavailable
|
|
- internal
|
|
referenceId:
|
|
type: string
|
|
description: Present on internal errors. Quote it when reporting a problem; it tags the server's log lines for this request.
|
|
errors:
|
|
type: array
|
|
description: Per-field failures. Present only when `code` is `validation`.
|
|
items:
|
|
$ref: ./ValidationError.yaml
|