# YOU(th) docs

> How partners connect their systems to YOU(th) checkups.

## Get started

- [Overview](https://website.youth-healthtech.com/docs.md): What partners get from YOU(th): events, FHIR, a read API and SDKs, and how they fit together. Preview: proposed, may change.
- [Quickstart](https://website.youth-healthtech.com/docs/quickstart.md): Receive a test event, verify it, and read a checkup's FHIR bundle. Preview: proposed, may change.
- [Concepts](https://website.youth-healthtech.com/docs/concepts.md): Organizations, members, checkups, biomarkers and measurements: the words these docs use. Preview: proposed, may change.
- [Authentication](https://website.youth-healthtech.com/docs/authentication.md): Get a short-lived token with OAuth2 client credentials, and call the API with it. Preview: proposed, may change.

## Webhooks

- [Events](https://website.youth-healthtech.com/docs/webhooks.md): What YOU(th) tells your system, and what each delivery carries. Preview: proposed, may change.
- [Verify a delivery](https://website.youth-healthtech.com/docs/webhooks/verify.md): Check each delivery's signature, in Node or Python. Preview: proposed, may change.
- [Retries and duplicates](https://website.youth-healthtech.com/docs/webhooks/retries.md): Answer fast, take each event once, and know when YOU(th) tries again. Preview: proposed, may change.
- [Catch up after an outage](https://website.youth-healthtech.com/docs/webhooks/catch-up.md): Read a checkup or a member with the read API, and list the checkups your system missed. Preview: proposed, may change.

## Data

- [FHIR](https://website.youth-healthtech.com/docs/data/fhir.md): A checkup as a FHIR bundle and a member as a Patient: the resources, codes and values. Preview: proposed, may change.
- [Biomarkers](https://website.youth-healthtech.com/docs/data/biomarkers.md): Every biomarker code a checkup's bundle can carry. Preview: proposed, may change.

## SDKs

- [Overview](https://website.youth-healthtech.com/docs/sdks.md): Run the checkup's captures inside your own app: what the SDKs do, and how to get them.
- [iOS](https://website.youth-healthtech.com/docs/sdks/ios.md): The SDK for native iOS apps, as a Swift package.
- [Flutter](https://website.youth-healthtech.com/docs/sdks/flutter.md): The SDK for Flutter apps, as a Dart package.
- [Web](https://website.youth-healthtech.com/docs/sdks/web.md): A web SDK, to run the captures in a browser, is planned. Preview: proposed, may change.

## Resources

- [Versions and changelog](https://website.youth-healthtech.com/docs/versions.md): How the read API and the webhook are versioned, and what has changed. Preview: proposed, may change.
- [Errors and rate limits](https://website.youth-healthtech.com/docs/errors.md): What a refused request answers, and the limits a client meets. Preview: proposed, may change.
- [Use the docs with AI](https://website.youth-healthtech.com/docs/ai.md): Hand a page or the whole docs to an assistant or a coding agent.

## Whole

- [Every page in one file](https://website.youth-healthtech.com/llms-full.txt): Every page of the docs, as one Markdown file.