Add the scaffolding for the API structure.

Author: Julian

pyproject.toml

@@ -32,6 +32,10 @@ classifiers = [
   "Topic :: File Formats :: JSON :: JSON Schema",
 ]
 dynamic = ["version"]
+dependencies = [
+  "pyyaml",
+  "referencing>=0.32.0",
+]
 
 
 [project.urls]

referencing_http/__init__.py

@@ -1,3 +1,8 @@
 """
-Fill me in!
+Serve your JSON registries over HTTP, for humans and machines alike!
 """
+from importlib.resources import files
+
+import yaml
+
+SPEC = yaml.safe_load(files(__package__).joinpath("api.yaml").read_text())

referencing_http/api.yaml

@@ -0,0 +1,25 @@
+openapi: "3.1.0"
+info:
+  title: An HTTP API for JSON (Schema) Registries
+  description: |-
+    Wrap a referencing.Registry Python object into an HTTP API.
+  version: "1.0"
+paths:
+  /list:
+    get:
+      summary: Retrieve a list of all URIs available in the registry.
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                const: 37
+  /contents:
+    get:
+      summary: Retrieve the contents of the given URI.
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                const: 137