API definitions
- OpenAPI: openapi.yaml — REST API for resolve, bulk-resolve, admin, system.
- Route directive schema: route-directive.schema.json — JSON Schema for RouteDirective and ResolveResponse.
- Protobuf: proto/resolver.proto — Resolver service and messages (ResolveRequest, ResolveResponse, RouteDirective). Package
as411.resolver.v1.
Generating stubs from Proto
From the repo root, with protoc installed:
# Example (adjust paths for your language)
protoc -I docs/api/proto docs/api/proto/resolver.proto --go_out=paths=source_relative:.
# Or with buf (if using buf.gen.yaml):
# buf generate docs/api/proto
gRPC server implementation is optional; the Proto file defines the contract for clients and future gRPC support.