API

پائپ لائنز (ترکیبیں)

ایک ہی کام ایک ہی عارضی سرور فائل پر کئی ٹول_آئی ڈی مراحل کو زنجیروں میں جوڑتا ہے۔ آپ کی درخواست میں ٹول_آئی ڈی فیلڈ کو پائپ لائن کے پہلے مرحلے سے مماثل ہونا چاہیے۔

ویب ہکس: ایک API کلید بنائیں (ایڈمن ہیڈر کے ساتھ POST /v1/api-keys)، PATCH /v1/api-keys/me/webhook کو ترتیب دیں، پھر اجازت کے ساتھ ملازمتیں بھیجیں: Bearer sk_…. دستخط: X-PulsConv-Signature اور X-PulsConv-Timestamp ہیڈر (JSON باڈی کا HMAC-SHA256)۔

JSON مثالیں (POST /v1/jobs)

پی ڈی ایف: سکیڑیں پھر حفاظت کریں۔

{
  "tool_id": "tool_pdf_compress",
  "upload_keys": ["uploads/xxx.pdf"],
  "options": { "quality": "ebook" },
  "pipeline": [
    { "tool_id": "tool_pdf_compress", "options": { "quality": "ebook" } },
    { "tool_id": "tool_pdf_protect", "options": { "password": "secret" } }
  ]
}

تصویر: سائز تبدیل کریں پھر ویب آپٹمائز کریں۔

{
  "tool_id": "tool_image_resize",
  "upload_keys": ["uploads/photo.jpg"],
  "options": { "width": 1200, "height": 1200, "mode": "contain" },
  "pipeline": [
    { "tool_id": "tool_image_resize", "options": { "width": 1200, "height": 1200, "mode": "contain" } },
    { "tool_id": "tool_image_optimize_web", "options": { "max_width": 1200, "quality": 82 } }
  ]
}

cURL example (POST /api/v1/jobs)

curl -sS -X POST "$API/api/v1/jobs" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "tool_pdf_compress",
    "upload_keys": ["uploads/mon.pdf"],
    "options": { "quality": "ebook" }
  }'

n8n — HTTP node

HTTP Request node → Method POST → URL {{$env.PULSCONV_API}}/api/v1/jobs
Body (JSON) : même objet que les exemples ci-dessus.
Réponse : { "id": "...", "status": "queued" }

For a webhook delivery log: keep traces on your endpoint (n8n, Zapier, your API); PulsConv can sign callbacks when you configure a secret.

تمام اوزار انضمام رابطہ