docs: API description with openapi + scalar (#32)

* chore(http): add apistos deps

* refactor(http): add openapi builder + scalar setup

* refactor(http): register models in apistos

* ci(py): bump runner macos-12 -> macos-13

* chore: bump to 0.3.0

* refactor(http): rename parameter ?top -> ?num

.github/workflows/maturin.yaml

@@ -109,7 +109,7 @@ jobs:
     strategy:
       matrix:
         platform:
-          - runner: macos-12
+          - runner: macos-13
             target: x86_64
           - runner: macos-14
             target: aarch64