Developer preview

Check physical placement against the same illustrative product areas used in the product studio. This staging API does not access artwork, accounts, orders or paid services.

Your staging keys

Sign in with your Design Doctor account, then load your keys. Each key can only check placement. Up to five active keys; expiration up to 90 days. Creating a key stores a hash; the full key cannot be retrieved later.

Placement API v1

POST /api/design-doctor/v1/placement accepts JSON. Use a bearer key, or X-Design-Doctor-Key alongside the existing staging HTTP Basic credentials. Keep keys in your server environment. Cross-origin browser access is not enabled.

{
  "productId": "tshirt",
  "zoneId": "left-chest",
  "widthIn": 3,
  "heightIn": 2,
  "offsetX": 0,
  "offsetY": 0
}

Dimensions are inches, greater than 0 and at most 60. Offsets are −60 to 60; omitted offsets default to zero. Unknown fields and product/zone combinations are rejected. Returns geometry, whether it fits, and remaining daily allowance. A fit is not supplier approval.

tshirt: left-chest, right-chest, center, front
polo: left-chest, right-chest, center, front
hoodie: left-chest, right-chest, center, front
tote: front
cap: front
patch: front
sticker: front

Responses: 200 result; 400 invalid input; 401 invalid/expired/revoked key; 409 concurrent request (retry); 413 body over 8 KB; 429 rate or daily limit; 503 unavailable. Authenticated requests count toward usage even when their input is invalid. Limit: 100 requests per key per UTC day, plus a shared IP burst limit. Counts are retained without request bodies.

No OAuth, webhooks, billing or production service guarantee is available in this preview.