Status: Coming soon. Enterprise tier akan dapat webhook subscription.

Apa yang akan di-support

Server POST ke URL kamu saat event tertentu. Payload JSON signed HMAC-SHA256.

Event types (planned)

Event Triggered saat
run.started Task run dimulai
run.completed Task run sukses selesai
run.failed Task run error
task.scheduled Schedule execution triggered
device.online Device baru konek
device.offline Device disconnect
license.expired License user expired
payment.received Pembayaran masuk

Payload format

{
  "event": "run.completed",
  "timestamp": "2026-04-25T10:00:00Z",
  "signature": "sha256=...",
  "data": {
    "run_id": "abc123",
    "task_id": "xyz789",
    "status": "success",
    "duration_ms": 45000,
    "device_serial": "ABCD1234"
  }
}

Registration API (planned)

POST /v1/webhooks
Authorization: Bearer <api_key>
{
  "url": "https://your-app.com/hooks/phonegrid",
  "events": ["run.completed", "run.failed"],
  "secret": "your_shared_secret"
}

Retry policy

  • Exponential backoff (1m, 5m, 15m, 1h, 6h, 24h)
  • Max 6 retries dalam 24 jam
  • Response 2xx = delivered; 4xx/5xx/timeout = retry

Sign verification

const sig = req.headers['x-phonegrid-signature'];
const body = req.rawBody;
const expected = 'sha256=' + hmac('sha256', SECRET, body);
if (sig === expected) { /* trusted */ }

Ini placeholder. Kalau kamu butuh webhook production-ready, hubungi support — kita bisa prioritize.