API پرو مجازی

احراز هویت

کلید را در هدر Authorization بفرستید. کلیدهای تست با hk_test_ و کلیدهای واقعی با hk_live_ شروع می‌شوند.

Authorization: Bearer hk_live_xxxxxxxxxxxxxxxx

ثبت پرو

POST https://houshstyle.ir/api/v1/try-on/ — multipart/form-data یا JSON با آدرس تصویر

curl -X POST https://houshstyle.ir/api/v1/try-on/ \
  -H "Authorization: Bearer $HUSH_KEY" \
  -F person_image=@person.jpg \
  -F garment_image=@dress.jpg \
  -F garment_type=w_gown \
  -F garment_image_2=@heels.jpg \
  -F garment_type_2=w_heels \
  -F resolution=hd \
  -F webhook_url=https://your-app.com/hooks/tryon

پاسخ (202):

{"id": "8b1c…", "status": "queued", "result_url": null, "credits_charged": 2, ...}

دریافت نتیجه

GET https://houshstyle.ir/api/v1/try-on/{id}/

وضعیت‌ها: queued، processing، completed، failed. در وضعیت completed، فیلد result_url آدرس تصویر نهایی است. اگر پرو ناموفق شود، اعتبار خودکار برمی‌گردد (refunded=true).

نمونه Python

import requests, time
H = {"Authorization": "Bearer hk_live_..."}
r = requests.post("https://houshstyle.ir/api/v1/try-on/", headers=H,
    files={"person_image": open("me.jpg", "rb"), "garment_image": open("dress.jpg", "rb")},
    data={"garment_type": "w_cocktail"})
job = r.json()
while job["status"] in ("queued", "processing"):
    time.sleep(2)
    job = requests.get(f"https://houshstyle.ir/api/v1/try-on/{job['id']}/", headers=H).json()
print(job["result_url"])

نمونه JavaScript (Node)

const fd = new FormData();
fd.append("person_image_url", "https://cdn.example.com/u/123.jpg");
fd.append("garment_id", "42");
const res = await fetch("https://houshstyle.ir/api/v1/try-on/", {
  method: "POST", headers: { Authorization: `Bearer ${process.env.HUSH_KEY}` }, body: fd });
console.log(await res.json());

نمونه PHP

$ch = curl_init("https://houshstyle.ir/api/v1/try-on/");
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("HUSH_KEY")],
  CURLOPT_POSTFIELDS => ["person_image" => new CURLFile("me.jpg"), "garment_image" => new CURLFile("coat.jpg"),
                         "garment_type" => "m_blazer"]]);
echo curl_exec($ch);

وب‌هوک

پس از پایان پردازش، یک POST با بدنه JSON و هدرهای زیر به webhook_url ارسال می‌شود:

X-Hush-Timestamp: 1760780000
X-Hush-Signature: sha256=HMAC_SHA256(webhook_secret, timestamp + "." + raw_body)

{"event": "tryon.completed", "data": {"id": "...", "status": "completed", "result_url": "..."}}

# Python verify
import hmac, hashlib
expected = hmac.new(SECRET.encode(), ts.encode() + b"." + body, hashlib.sha256).hexdigest()
assert hmac.compare_digest("sha256=" + expected, signature)

سایر endpointها

• GET /api/v1/usage/ — اعتبار باقی‌مانده و مصرف ماه جاری
• GET /api/v1/garments/ — لباس‌های قابل پرو (عمومی + محصولات شما)
• GET /api/v1/try-on/list/ — ۵۰ پرو اخیر

کدهای خطا

انواع لباس و اکسسوری (garment_type)

کلیدهای u_ یونیسکس هستند. نام‌های قدیمی انگلیسی (مثل cocktail dress) هنوز پذیرفته می‌شوند.

لباس — زنانه

لباس — مردانه

ست و سرهمی — زنانه

ست و سرهمی — مردانه

ست و سرهمی — یونیسکس

اکسسوری — زنانه

اکسسوری — مردانه

اکسسوری — یونیسکس