Webhooks

import httpx

async with httpx.AsyncClient() as client:
    response = await client.post(
        "https://api.humancheck.dev/webhooks",
        headers={
            "Authorization": "Bearer your-api-key-here",
            "Content-Type": "application/json"
        },
        json={
            "url": "https://your-app.com/webhooks/humancheck",
            "events": [
                "review.created",
                "review.assigned",
                "review.decided",
                "review.status_changed"
            ],
            "secret": "your-webhook-secret",
            "active": True
        }
    )
    webhook = response.json()

{
  "event": "review.decided",
  "timestamp": "2024-01-01T12:00:00Z",
  "data": {
    "review_id": 123,
    "task_type": "payment",
    "status": "approved",
    "decision": {
      "decision_type": "approve",
      "reviewer_name": "Alice Smith",
      "timestamp": "2024-01-01T12:00:00Z"
    }
  }
}

import hmac
import hashlib

def verify_webhook(payload, signature, secret):
    expected_signature = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected_signature)

{
  "workflow_type": "sequential",
  "approvers": ["alice@example.com", "bob@example.com"],
  "current_step": 1,
  "total_steps": 2
}

{
  "workflow_type": "parallel",
  "approvers": ["alice@example.com", "bob@example.com"],
  "required_approvals": 2
}

{
  "workflow_type": "conditional",
  "conditions": [
    {
      "if": "amount > 10000",
      "then": ["finance@example.com"]
    },
    {
      "if": "urgency == 'critical'",
      "then": ["oncall@example.com"]
    }
  ]
}