📚 Katalog Dokumentasi API
Semua endpoint memakai HTTPS + JSON. Base URL: https://api.aifengdcs.com (lingkungan demo, SIM).
🔐 Autentikasi & Tanda Tangan
Setiap request membawa header X-App-Key dan tanda tangan HMAC-SHA256 dari 'timestamp + body' memakai AppSecret, dikirim lewat header X-Sign; tanda tangan berlaku 5 menit.
⚠️ Kode Error
401 tanda tangan tidak valid / 403 kunci belum disetujui atau nonaktif / 409 konflik kunci idempotensi / 429 melebihi batas laju / 460 saldo Bean kurang / 500 gangguan server (boleh coba lagi).
🚦 Batas Laju
Default 60 panggilan/menit per kunci; maksimal 5 tugas asinkron bersamaan; setelah kuota gratis habis dikenakan harga Bean, saldo kurang mengembalikan 460.
📞 Protokol Callback
Callback berupa POST JSON dengan header X-Sign (aturan sama seperti tanda tangan request); server Anda harus membalas 200 dalam 10 detik, jika tidak dianggap gagal dan dikirim ulang.
Daftar Endpoint
🛰️ API Pengumpulan
POST /openapi/v1/collect/products
Kumpulkan judul, foto utama, dan spesifikasi produk secara massal berdasarkan kata kunci atau tautan toko; hasil JSON terstruktur siap masuk alur mockup.
🫘 2 Bean/panggilan · Gratis 50x/hari
✂️ API Ekstraksi
POST /openapi/v1/extract/design
Ekstrak lapisan desain berlatar transparan dari foto produk; hasil PNG alpha beserta koordinat elemen untuk penataan ulang.
🫘 3 Bean/panggilan · Gratis 30x/hari
🎨 API Teks-ke-Gambar
POST /openapi/v1/images/generate
Hasilkan motif cetak orisinal dari prompt tiga bahasa dengan parameter ukuran dan gaya; hasil bersifat simulasi (SIM) untuk validasi alur.
🫘 10 Bean/panggilan · Gratis 10x/hari
🖼️ API Matting
POST /openapi/v1/images/matting
Hapus latar foto orang/produk dalam satu klik; hasil PNG transparan dengan parameter feather, mendukung tugas massal asinkron.
🫘 4 Bean/panggilan · Gratis 20x/hari
👕 API Mockup
POST /openapi/v1/mockups/render
Terapkan desain ke template kaos, mug, casing HP, dan produk lain secara massal; hasilkan banyak mockup sekaligus.
🫘 6 Bean/panggilan · Gratis 15x/hari
🚀 API Publikasi
POST /openapi/v1/listings/push
Susun mockup menjadi draf produk ke area peninjauan toko; publikasi resmi selalu menunggu persetujuan Human-Gate, tidak pernah otomatis.
🫘 2 Bean/panggilan · Gratis 20x/hari
🛡️ API Deteksi Hak Cipta
POST /openapi/v1/ipcheck/scan
Pindai kemiripan merek/hak cipta pada desain (hasil simulasi + tanda SIM); keluarkan tingkat risiko dan contoh temuan.
🫘 5 Bean/panggilan · Gratis 25x/hari