API
ਪਾਈਪਲਾਈਨਾਂ (ਪਕਵਾਨਾਂ)
ਇੱਕ ਸਿੰਗਲ ਨੌਕਰੀ ਇੱਕੋ ਅਸਥਾਈ ਸਰਵਰ ਫਾਈਲ 'ਤੇ ਕਈ ਟੂਲ_ਆਈਡੀ ਕਦਮਾਂ ਨੂੰ ਚੇਨ ਕਰਦੀ ਹੈ। ਤੁਹਾਡੀ ਬੇਨਤੀ ਵਿੱਚ ਟੂਲ_ਆਈਡੀ ਖੇਤਰ ਪਹਿਲੇ ਪਾਈਪਲਾਈਨ ਪੜਾਅ ਨਾਲ ਮੇਲ ਖਾਂਦਾ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ।
ਵੈਬਹੁੱਕ: ਇੱਕ API ਕੁੰਜੀ ਬਣਾਓ (ਪ੍ਰਬੰਧਕ ਸਿਰਲੇਖ ਦੇ ਨਾਲ POST /v1/api-keys), PATCH /v1/api-keys/me/webhook ਨੂੰ ਕੌਂਫਿਗਰ ਕਰੋ, ਫਿਰ ਅਧਿਕਾਰ ਦੇ ਨਾਲ ਨੌਕਰੀਆਂ ਭੇਜੋ: Bearer sk_…. ਦਸਤਖਤ: X-PulsConv-ਦਸਤਖਤ ਅਤੇ X-PulsConv-ਟਾਈਮਸਟੈਂਪ ਹੈਡਰ (JSON ਬਾਡੀ ਦਾ HMAC-SHA256)।
JSON ਉਦਾਹਰਨਾਂ (ਪੋਸਟ /v1/ਨੌਕਰੀਆਂ)
PDF: ਸੰਕੁਚਿਤ ਕਰੋ ਫਿਰ ਸੁਰੱਖਿਅਤ ਕਰੋ
{
"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.
