# care — Orbit integration API

> Read-only API for the Orbit app (orbit.codebros.cz) to pull site-monitoring
> data from care into its Work module. Server-to-server, authenticated with a
> per-user bearer key (Authorization: Bearer <apiKey>). All data is scoped to
> the user that owns the key. Missing/invalid/revoked key returns HTTP 401.

## Docs

- [OpenAPI 3.1 spec](https://api.care.codebros.cz/openapi.json): machine-readable contract (schemas + bearer scheme)
- [Orbit API reference (Markdown)](https://api.care.codebros.cz/docs/orbit-api.md): overview, auth, per-endpoint curl + example JSON

## Endpoints

- GET https://api.care.codebros.cz/api/orbit/ping: health + identity check
- GET https://api.care.codebros.cz/api/orbit/summary: monitoring snapshot (sites, sitesDown, openIncidents, jobsToday, uptime24hPct)
- GET https://api.care.codebros.cz/api/orbit/clients/{id}/summary: same snapshot scoped to one client; {id} = client's link contact id; 404 if unknown/not owned
- GET https://api.care.codebros.cz/api/orbit/sites: the owner's sites (id, name, url) for Orbit's external-resource picker