# Rails Sandbox — a Rails-compatible API

> A faithful mock of the public 2026-01 Integrations API for collision-repair parts procurement, documented for humans and AI agents alike. Not a real vendor's documentation; two procurement-completion methods are clearly-labelled proposed extensions.

## Docs
- [Rails Sandbox](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/index.md): A Rails-compatible parts-procurement sandbox documented for humans and AI agents.
- [Quickstart](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/quickstart.md): Zero to a confirmed parts order in under five minutes, copy-paste curl.
- [Authentication](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/authentication.md): Exchange a pre-registered client for an org-scoped api_key, then send it with Partly-Integration-ID on every call.
- [Procurement lifecycle](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/lifecycle.md): From vehicle prep to a confirmed order — the state machine, plus the proposed extensions beyond it.
- [Webhooks](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/webhooks.md): Signed, at-least-once event delivery — and exactly how to verify the HMAC signature.
- [Errors](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/errors.md): Coded, type-tagged errors written to be read by LLMs and humans alike.
- [Versioning & changelog](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/versioning.md): A date-versioned API (2026-01) carried in the URL path, plus a dated changelog of Rails Sandbox changes.
- [For AI agents](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/for-ai-agents.md): How a coding agent should consume these docs and the companion Rails MCP.
- [API Reference](https://partifact-mock-rails.thanhvuttv.workers.dev/docs/api-reference.md): Every 2026-01 wire method with request/response/error schemas and a runnable curl, plus the proposed extensions.

## Machine-readable
- [OpenAPI spec](https://partifact-mock-rails.thanhvuttv.workers.dev/openapi.json): The 2026-01 contract — typed request/response/error schemas.
- [Full docs](https://partifact-mock-rails.thanhvuttv.workers.dev/llms-full.txt): Every page's markdown concatenated into one document.