Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Taxi - Describe How Your APIs and Data Relate Schemas API

Taxi schema management and compilation

This API exposes 4 operations across 3 paths, and defines 12 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://api.taxilang.org.

4 operations 3 paths 12 schemas 2 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Server
https://api.taxilang.org
License
Resource Areas
1

Paths & Operations 4

Across 3 paths, the API surfaces 4 operations — 2 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Schemas 4

Taxi schema management and compilation

GET
/schemas
List Schemas
listSchemas 2 params → 200
POST
/schemas
Register Schema
registerSchema body → 201400
GET
/schemas/{schema_id}
Get Schema
getSchema 1 param → 200404
POST
/schemas/compile
Compile Schema
compileSchema body → 200400

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are Schema (9 properties), TypeDefinition (6 properties), OperationDefinition (5 properties), TypeField (4 properties). Each schema is shown below with its type and property counts.

TypeDefinition
object
6 properties
ServiceDefinition
object
4 properties
CompileResult
object
4 properties
TypeField
object
4 properties
SchemaRegistrationRequest
object
3 properties 2 required
SchemaList
object
2 properties
Error
object
3 properties
Schema
object
9 properties
CompileError
object
4 properties
CompileRequest
object
2 properties 1 required
OperationDefinition
object
5 properties
OperationParameter
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

taxi-schemas-api-openapi.yml Raw ↑