Minimal example for api endpoint

software/src/microdot/main.py

@@ -35,4 +35,16 @@ async def index(request):
     print(f"  cookies: {request.cookies}")
     return "TonberryPico says 'Hello World!'"
 
+
+@app.route('/v1/api/playback/control', methods=['POST'])
+async def playback_control(request):
+    if not request.json:
+        return {'success': False}
+
+    # Example:
+    # curl -H "Content-Type: application/json" --data '{"action": "play", "target_type": "audio_file", "target_id": "1234"}' http://192.168.4.1/v1/api/playback/control
+    print(f'Calling {request.json["action"]} on {request.json["target_type"]} with id \
+            {request.json["target_id"]}')
+
+
 app.run(port=80)

software/src/microdot/tonberry.schema.json

@@ -0,0 +1,53 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "definitions": {
+      "PlaybackPosition": {
+        "type": "object",
+        "properties": {
+          "position_seconds": { "type": "number" },
+          "device_uptime": { "type": "number" }
+        },
+        "required": ["position_seconds"]
+      },
+      "AudioFile": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string", "format": "uuid" },
+          "filename": { "type": "string" },
+          "size_bytes": { "type": "integer" },
+          "duration_seconds": { "type": "number" },
+          "last_played_uptime": { "type": "number" },
+          "playback_position": { "$ref": "#/definitions/PlaybackPosition" }
+        },
+        "required": ["id", "filename"]
+      },
+      "Playlist": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string", "format": "uuid" },
+          "name": { "type": "string" },
+          "audio_files": {
+            "type": "array",
+            "items": { "$ref": "#/definitions/AudioFile" }
+          },
+          "current_track_index": { "type": "integer", "minimum": 0 },
+          "last_played_uptime": { "type": "number" },
+          "playback_position": { "$ref": "#/definitions/PlaybackPosition" }
+        },
+        "required": ["id", "name", "audio_files"]
+      },
+      "NfcTag": {
+        "type": "object",
+        "properties": {
+          "uid": { "type": "string" },
+          "name": { "type": "string" },
+          "linked_type": { 
+            "type": "string",
+            "enum": ["audio_file", "playlist"]
+          },
+          "linked_id": { "type": "string", "format": "uuid" }
+        },
+        "required": ["uid", "linked_type", "linked_id"]
+      }
+    }
+  }