Guides
End-user limits
Use end_user_id with dashboard cooldown and monthly caps for shoppers.
End-user limits
Optional controls let you rate-limit shoppers (end-users) without creating DrapeItOn accounts for them.
end_user_id
On POST /v1/generations, you may send:
"end_user_id": "your-stable-shopper-id"- Optional string, max length 100
- Opaque to DrapeItOn — use your own customer or session id
- If omitted, cooldown and monthly limits for shoppers do not apply to that request
Dashboard settings
In the dashboard (limits / settings), you can configure for your account:
| Control | Effect |
|---|---|
| Cooldown | Minimum seconds between successive try-on submissions for the same end_user_id |
| Monthly limit | Maximum try-ons allowed per end_user_id per calendar month (or unlimited) |
Exact UI labels may vary; values are stored on the business account and enforced on Integration API submit when end_user_id is present.
API errors
| Situation | Code (typical) |
|---|---|
| Cooldown still active | COOLDOWN_ACTIVE (HTTP 429) |
| Monthly cap reached | MONTHLY_LIMIT_EXCEEDED (HTTP 429) |
Handle these in your shopper UX (wait / upgrade / block further tries). See Errors and retries.