📚 API Documentation Index
All endpoints use HTTPS + JSON. Base URL: https://api.aifengdcs.com (demo environment, SIM).
🔐 Auth & Signing
Every request carries an X-App-Key header plus an HMAC-SHA256 signature of 'timestamp + body' made with the AppSecret, sent in the X-Sign header; signatures expire after 5 minutes.
⚠️ Error Codes
401 invalid signature / 403 key not approved or disabled / 409 idempotency-key conflict / 429 rate limit exceeded / 460 insufficient Bean balance / 500 server error (retryable).
🚦 Rate Limits
Default 60 calls/minute per key; max 5 concurrent async jobs; after the free quota, calls are billed per Bean and an empty balance returns 460.
📞 Callback Protocol
Callbacks are POST JSON carrying an X-Sign header (same rule as request signing); your server must answer 200 within 10 seconds or the push is retried.
Endpoint List
🛰️ Collection API
POST /openapi/v1/collect/products
Bulk-collect product titles, main images and specs by keyword or shop link; returns structured JSON ready for the mockup pipeline.
🫘 2 Beans/call · 50 free calls/day
✂️ Extraction API
POST /openapi/v1/extract/design
Extract a transparent-background design layer from a product image; outputs alpha PNG plus element coordinates for re-layout.
🫘 3 Beans/call · 30 free calls/day
🎨 Text-to-Image API
POST /openapi/v1/images/generate
Generate original print artwork from trilingual prompts with size and style parameters; results are simulated (SIM) for flow validation.
🫘 10 Beans/call · 10 free calls/day
🖼️ Matting API
POST /openapi/v1/images/matting
One-click background removal for people/products; returns transparent PNG with feathering controls and async batch callbacks.
🫘 4 Beans/call · 20 free calls/day
👕 Mockup API
POST /openapi/v1/mockups/render
Apply artwork to T-shirt, mug, phone-case and other templates in bulk; renders multi-product mockups and detail image sets in one call.
🫘 6 Beans/call · 15 free calls/day
🚀 Listing API
POST /openapi/v1/listings/push
Assemble mockups into product drafts pushed to the shop review area; official publishing always waits for Human-Gate approval, never automatic.
🫘 2 Beans/call · 20 free calls/day
🛡️ IP Infringement Check API
POST /openapi/v1/ipcheck/scan
Scan artwork for trademark/copyright similarity (simulated results + SIM tag); outputs risk level and sample matches to cut listing risk.
🫘 5 Beans/call · 25 free calls/day