# Documentation

- [Documentation](/docs): Guides and concepts for integrating the DrapeItOn virtual try-on API.
- Getting started
  - [Introduction](/docs/getting-started/introduction): What DrapeItOn is for brands, and how the Integration API fits next to the dashboard.
  - [Quickstart](/docs/getting-started/quickstart): Run your first virtual try-on with the Integration API — from API key to result image.
- Guides
  - [Authentication](/docs/guides/authentication): Authenticate Integration API requests with API keys.
  - [Uploading images](/docs/guides/uploading-images): How person and garment image URLs work with presigned upload and generation.
  - [Submitting generations](/docs/guides/submitting-generations): How to create try-on jobs and list them via the Integration API.
  - [Handling results](/docs/guides/handling-results): Poll generation status or use webhooks to receive try-on outcomes.
  - [Webhooks](/docs/guides/webhooks): Receive generation results asynchronously and verify request signatures.
  - [Errors and retries](/docs/guides/errors-and-retries): Error response shape, common codes, rate limiting, and retry behavior.
  - [End-user limits](/docs/guides/end-user-limits): Use end_user_id with dashboard cooldown and monthly caps for shoppers.
- Concepts
  - [Overview](/docs/concepts/overview): Core entities in the DrapeItOn Integration API — accounts, keys, shoppers, jobs, credits, and webhooks.
  - [Generations](/docs/concepts/generations): What a try-on job is, how statuses progress, and how results are delivered.
  - [Credits](/docs/concepts/credits): How try-on usage is billed in credits, balance checks, refunds, and how to top up.
  - [Categories](/docs/concepts/categories): Garment categories required on every generation request.

## API Reference

Live Integration API (do not require a browser):

- [Integration API — Markdown for LLMs](https://api.drapeiton.com/reference.md)
- [Integration API — OpenAPI JSON](https://api.drapeiton.com/openapi.json)
- [Integration API — Interactive docs](https://api.drapeiton.com/docs)