Initial BinaryLane v2 API client

2026-10-21 23:32:36 +10:00 · 2026-08-16 21:52:42 +10:00
commit fcd0d22b0d
91 changed files with 18691 additions and 0 deletions
@@ -0,0 +1,21 @@
+# BinaryLane API contract
+
+`binarylane-v2.openapi.yaml` is an unmodified snapshot of BinaryLane's published
+OpenAPI document. Its provenance and digest are recorded in `contract.json`.
+
+The provider currently describes the API as a developer preview, so an upstream
+version number alone must not be used as a compatibility guarantee. The contract
+monitor compares the document digest as well as its declared version.
+
+## Normalization rule
+
+The document has 52 routable paths and 42 additional paths such as
+`/v2/servers/{server_id}/actions#PowerOn`. The latter are documentation aliases
+for payload variants of `POST /v2/servers/{server_id}/actions`; URI fragments do
+not reach an HTTP server. They must be removed before an OpenAPI generator is
+asked to create a route surface. `normalization.json` records the exact rule and
+each affected path.
+
+Public SDK DTOs deliberately model all provider enum values as strings. This is
+forward-compatible with a preview API that may add a value before a new SDK
+release is available.