# One Care Portal Developer Resources

Official public resources for One Care Portal agents and developers. These endpoints are read-only and contain no customer data or PHI.

## API

- [API v1 index](https://onecareportal.com/api/v1)
- [Product catalog](https://onecareportal.com/api/v1/catalog)
- [OpenAPI specification](https://onecareportal.com/.well-known/openapi.json)
- [Versioning and deprecation policy](https://onecareportal.com/docs/api-versioning)

## Protocol conventions

- **Authentication:** None for the documented public read-only catalog.
- **Errors:** RFC 9457 `application/problem+json` with `code` and `resolution_hint` extensions.
- **Rate limit:** 60 requests per 60 seconds per domain and client IP. Read `RateLimit-Limit` and `RateLimit-Policy`; honor `Retry-After` on 429.
- **Markdown:** Canonical HTML pages negotiate `text/markdown`, emit `Vary: Accept`, honor q-values, and return 406 for unsatisfiable requests.
- **Webhooks and MCP:** No public webhook or MCP server is offered at this time.

## Other indexes

- [LLM index](https://onecareportal.com/llms.txt)
- [Full AI-readable reference](https://onecareportal.com/llms-full.txt)
- [XML sitemap](https://onecareportal.com/sitemap.xml)
- [Product documentation](https://onecareportal.com/docs)