Upcoming version
You're browsing the documentation for an upcoming version. Its documentation and features are subject to change.
Harbour
The next Harbour API, still being written.
A worked example, and nothing more: no host behind this replies, save the one operation that says it does.
This is the unreleased line. Everything in 3.x is here unchanged; what is new is the Events tag, and it may still change before it ships.
Harbour moves consignments through berths. The nouns are made up; the shapes are the point — this document exists so the reference pages have every construct of OpenAPI 3.1 to render, including the ones that are easy to leave out.
- 4.0.0-rc.1
- API version
- 10
- Operations
- 6
- Groups
- 2
- Servers
Endpoints
- Consignments5Everything that is a consignment — a load of freight, with a reference on it and a berth to end up at.
- Vessels1The ships consignments travel on, and what they are carrying.
- Batches1Operations that act on many consignments at once.
- Events1New in this line. A consignment's own history, as it happens, rather than a page of it fetched again and again.
- Demo1The one part of this document that is real: an endpoint this very site answers, so the try-it client on the landing page sends a request and gets something back rather than failing against a host that does not exist.
- Webhooks1
Servers
https://api.example.org/{stage}The invented production host.
- stage
- v3
- v1 · v2 · v3
http://localhost:8080A local process, for trying things out.
Authentication
apiKeyapiKey · X-Api-Key · HeaderA key from the account page.
bearerhttp · bearerA token obtained from the authorisation server.
oauthoauth2For applications acting on someone else's behalf.