For developers
Read the recipe first. This page is the index behind it. Choose an outcome is the index in front of it.
The integrator checklist is the short order of operations: key, canonical calls, then the platform app if the merchant is on Shopify or WooCommerce.
Hosts
| Host | Use it for | Credential |
|---|---|---|
| api.wearfits.com | POST /api/v1/shoe-3d, GET /api/v1/jobs/{jobId}, POST /api/v1/digital-twin, POST /api/v1/virtual-fitting, POST /api/v1/size-fitting |
X-API-Key from the Dashboard, server-side |
| dev.wearfits.com | AR library, model upload, viewer at /tryon |
Dashboard account, or the upload API's own auth as documented |
| tryon.wearfits.com | Clothing embed, shoe sandbox at /shoes, hosted integration notes |
Shoppers: none. Sandbox and API: the Dashboard key |
| size.wearfits.com | Foot scan and sdk/v1/index.js |
Public clientId registered by WEARFITS. Not the API key. |
| dash.wearfits.com | Keys, usage, billing | Magic link. Shopify merchants skip it. |
Interactive API explorer: api.wearfits.com/reference.
Calls, and the page that specifies them
| Job | Call | Reference |
|---|---|---|
| Shoe photos to a model | POST /api/v1/shoe-3d, then GET /api/v1/jobs/{jobId} |
2D to 3D API |
| Upload a shoe GLB | POST /tryon/api/upload_shoe on dev.wearfits.com, header Authorization: Bearer |
AR API. Bags and non-GLB files use the library UI, not this call. Viewer: AR SDK |
| Clothing twin and fitting | POST /api/v1/digital-twin, POST /api/v1/virtual-fitting |
Clothing API, Clothing SDK |
| Clothing size | POST /api/v1/size-fitting |
Recommend a clothing size |
| Shoe size | Size SDK. No size-fitting call. | Recommend a shoe size, Size SDK |
New shoe integrations use POST /api/v1/shoe-3d. Do not invent a /shoe3d path.
Hosted embed notes also live at tryon.wearfits.com/docs/integration-shoes and tryon.wearfits.com/docs/integration.
Rules that keep an integration valid
- Choose the recipe before choosing an endpoint. Visual try-on and size are different products.
- Keep the API key on the server. Browser snippets for AR and clothing follow the SDK guide for that product.
- Shoe size: register origins first, send millimetres, treat
confidence: "advisory"as a hard constraint. Do not block checkout. - Clothing size: body ranges, chart version
1, basis"body". A photo-mode twin returnsavailable: false. - Usage for AR and clothing try-on is reported by the product SDKs. There is no public API for custom server-to-server usage reporting.
- Prefer the Shopify app or the WooCommerce plugin when the merchant is on that platform. Build a custom embed when the recipe says the app does not cover the outcome (shoe size, bags).
Markdown link
Every page on this wiki has Copy Markdown link at the top. It copies an absolute URL such as https://wiki.wearfits.com/md/shoes/recommend-size.md. Opening that URL returns the page's Markdown, not the HTML. Give that URL to an agent when it should read one page.
The same control on a preview host copies that host's origin, so the link matches the site you are looking at.
Reference library
The product manuals — user guides, API references, and SDK guides — are under Reference in the sidebar. Use them for fields and error codes after the recipe has named the outcome.