# Assistants de programmation basés sur l'IA

Laissez Claude Code, Codex ou Cursor s'occuper de l'intégration à votre place. Deux possibilités :

1. **Consultez la documentation.** Chaque page dispose d'une version Markdown (ajoutez `.md` à l'URL ou utilisez l'option **Copier la page** en haut de la page). L'intégralité de la documentation est également disponible à l'adresse [/llms-full.txt](/llms-full.txt).
2. **Connectez-vous au serveur MCP** afin que l'assistant puisse lire ces documents et effectuer de véritables essais virtuels pendant la compilation. Voir « [Serveur MCP](/docs/mcp) ».

## Où placer les instructions ?

| Assistant(e) | Insérez le contrat ci-dessous dans |
|---|---|
| Claude Code | `CLAUDE.md`, situé à la racine de votre projet |
| Codex | `AGENTS.md`, situé à la racine de votre projet |
| Cursor | `.cursor/rules/tryoncloud.mdc` ou collez-le dans la discussion |
| Autre | Coller dans la discussion |

Demandez ensuite : « Ajouter l'essayage virtuel TryOnCloud à l'aide du contrat figurant dans CLAUDE.md » (ou AGENTS.md). Conservez votre clé dans une variable d'environnement telle que `TRYONCLOUD_API_KEY`, jamais dans le fichier.

## Le contrat

```text
You are integrating the TryOnCloud Developer API into my app.

ENDPOINT
  POST https://www.tryoncloud.com/api/v1/generate
  Test mode (free, nothing generated or stored): add ?mock=true

AUTH
  Header X-API-KEY, read from env TRYONCLOUD_API_KEY (starts with tk_dev_v1_)

REQUEST: multipart/form-data OR JSON. Two images required:
  garment_image (file) OR garment_url (public https URL) OR garment_base64
  person_image (file) OR person_base64
  JPEG, PNG, WebP or HEIC, up to 15MB each.
  Optional: customer_id (my own end-user id, max 128 chars).
  Optional header: Idempotency-Key (a new UUID per try-on; reuse it only
  when retrying that same try-on, so it is never charged twice).

RESPONSE
  200 -> the response BODY IS the finished try-on image (image/png).
         Read it as bytes, do NOT JSON.parse it. Store it yourself.
         Headers: X-Request-Id (log it), X-Credit-Was-Free, X-Result-Id
         (only if result storage is enabled), X-Mock: 1 in test mode.
  non-200 -> JSON { "error": string, "code": string }:
    401 NO_KEY, INVALID_KEY | 400 BAD_INPUT, NO_PERSON, NO_GARMENT
    402 NO_CREDITS, QUOTA_EXCEEDED, FREE_TRIAL_USED, KEY_LIMIT_REACHED
    403 DEVICE_BANNED | 409 IDEMPOTENCY_IN_PROGRESS, IDEMPOTENCY_REPLAY,
    IDEMPOTENCY_MISMATCH (not charged)
    413 IMAGE_TOO_LARGE | 422 CONTENT_FILTERED (refunded)
    429 RATE_LIMITED (wait Retry-After) | 500 GENERATION_FAILED (refunded)

OTHER ENDPOINTS
  GET    https://www.tryoncloud.com/api/v1/credits          -> { credits_remaining, ... }
  DELETE https://www.tryoncloud.com/api/v1/results/<id>     -> 204
  Async (only if I ask for it): POST /api/v1/generations -> 202 job;
  GET /api/v1/generations/<id>; POST /api/v1/batches (<= 500 URL items);
  signed webhooks generation.completed / generation.failed / batch.completed
  (verify x-tryoncloud-signature-v2 = HMAC-SHA256 of "<timestamp>.<raw body>").
  Spec: https://www.tryoncloud.com/api/v1/openapi.json

RULES
  - Call from my server only, never the browser; never expose the key.
  - Client timeout 120 seconds; a typical result takes about 20 seconds.
  - Build and test with ?mock=true first, then remove it.
  - Retry 500 once and 429 after Retry-After. Never loop on 402.
  - Only send photos of adults who agreed to the try-on.

Write production code for [MY STACK] that uploads two images, calls this
endpoint, handles every error code above, and saves/returns the PNG.
```

Remplacez `[MY STACK]` par le vôtre, par exemple « un gestionnaire de route Next.js », « Laravel », « Django » ou « Express ».
