# Lanoo API

> Reserve a spot for a robotaxi between rides. Lanoo is the neutral reservation layer for robotaxis.

One API to find a free spot in a shared staging area, hold it for one
vehicle, and check in and out. Every staging area on Lanoo, for every
operator, through the same connection.

Versions are named by the date they were released. Send the one you
built against in a `Lanoo-Version` header; without it, a call uses the
version your account was pinned to on its first call. A version never
changes in a way that breaks you; new fields may appear in it, so
ignore fields you do not know.

The API is in development. Nothing here can be called yet, and any of it
may change before it can.

## Guides

- [Getting an API key](https://golanoo.com/docs/guides/getting-an-api-key.md): Get a test key to start building, a live key when you are ready, and keep both safe.
- [Your first request](https://golanoo.com/docs/guides/your-first-request.md): Check that your key works by asking for the staging areas you can use, and learn what comes back.
- [Your first reservation](https://golanoo.com/docs/guides/your-first-reservation.md): Take one vehicle from start to finish: find room, reserve a spot, check in, and check out.
- [Going live](https://golanoo.com/docs/guides/going-live.md): What to check before your vehicles reserve real spots, and how to switch to your live key.
- [Finding room](https://golanoo.com/docs/guides/finding-room.md): Search for staging areas with room near a point, now or at the time your vehicle arrives, and read what free_spots and chance_free tell you.
- [Holding a spot](https://golanoo.com/docs/guides/holding-a-spot.md): How a hold works, what to do when your vehicle runs late, and what happens when a hold runs out or a staging area is full or closed.
- [Checking in and out](https://golanoo.com/docs/guides/checking-in-and-out.md): Check a vehicle in when it reaches its spot, check it out when it leaves, and handle a hold that ran out or a stay that ran over.
- [When a staging area closes](https://golanoo.com/docs/guides/when-a-staging-area-closes.md): Planned closures for repairs, sudden ones for the police or a fire, and what each means for a vehicle that holds a spot or is parked there.
- [Receiving webhooks](https://golanoo.com/docs/guides/receiving-webhooks.md): Register an endpoint, test it, check each event's signature, and act on expired holds, cancellations, overstays and staging area changes.

## API reference

- [Introduction](https://golanoo.com/docs/api.md): How the Lanoo API works: base URL, keys, versions, idempotency, errors, pagination and ids, with a page for each resource.
- [Staging areas](https://golanoo.com/docs/api/staging-areas.md)
- [Availability](https://golanoo.com/docs/api/availability.md)
- [Reservations](https://golanoo.com/docs/api/reservations.md)
- [Webhooks](https://golanoo.com/docs/api/webhooks.md)
- [OpenAPI file](https://golanoo.com/docs/openapi.yaml)

## Optional

- [Changelog](https://golanoo.com/docs/changelog.md): Every change to the Lanoo API, newest first. A version is named by the date it was released.