Files
Sansan f7619baf34 Use /api/v1 with token authentication and typed responses
Closes #38, #39 and #40; adds the client side of #41.

- Every request goes to /api/v1. MusicServerClient gets a token with
  Settings.api_password the first time one is needed, reuses it, and on a
  401 gets a new one and sends the request once more. Switching server gets
  a new token too. Callers never see the token.
- Sync is started with POST, as MusicServer 5.0 requires.
- The client has every endpoint in the server's OpenAPI spec, including
  statistics, soundtracks and songs by UUID, version, downloads and tokens.
- tools/generate_api_types.gd generates a typed class per schema in
  server/openapi.json into server/generated/. Song info, statistics and
  versions are passed to callers as these classes. A list the server sends
  as null is an empty list.
- FakeHttpTransport hands out tokens and answers 401 without one, so every
  test goes through the token flow. New tests cover the token handling,
  every endpoint and each generated class.
2026-10-06 22:45:28 +02:00

37 lines
1.2 KiB
GDScript

# Generated by tools/generate_api_types.gd from server/openapi.json.
# Do not edit; change the server and generate again.
class_name Song
extends RefCounted
## The [code]Song[/code] schema of the MusicServer API.
var file_name: String
var name: String
var soundtrack_name: String
var soundtrack_uuid: String
var times_played: int
var uuid: String
## Reads the fields from parsed JSON. Missing fields keep their defaults.
static func from_dict(data: Dictionary) -> Song:
var result: Song = Song.new()
result.file_name = ApiJson.get_string(data, "file_name", "")
result.name = ApiJson.get_string(data, "name", "")
result.soundtrack_name = ApiJson.get_string(data, "soundtrack_name", "")
result.soundtrack_uuid = ApiJson.get_string(data, "soundtrack_uuid", "")
result.times_played = ApiJson.get_int(data, "times_played", 0)
result.uuid = ApiJson.get_string(data, "uuid", "")
return result
## Returns the fields under their JSON names, ready for [method JSON.stringify].
func to_dict() -> Dictionary:
return {
"file_name": file_name,
"name": name,
"soundtrack_name": soundtrack_name,
"soundtrack_uuid": soundtrack_uuid,
"times_played": times_played,
"uuid": uuid,
}