from metrifox_sdk import MetrifoxClient
import time

client = MetrifoxClient(api_key="your_api_key")

# Basic usage recording
response = client.usages.record_usage({
    "customer_key": "cust-6d11ca90",
    "event_name": "candidate.sourced",
    "amount": 2,
    "event_id": "evt_12345",  # required idempotency key
    "timestamp": int(time.time() * 1000)  # recommended
})

# Usage recording with all optional fields
response = client.usages.record_usage({
    "customer_key": "cust-6d11ca90",
    "event_name": "premium.feature",
    "amount": 3,
    "credit_used": 10,
    "event_id": "evt_external_789",
    "timestamp": 1703246400000,
    "metadata": {
        "feature_type": "advanced",
        "user_tier": "premium"
    }
})

{
  "data": {
    "customer_key": "cust-mit7k5v8obzs",
    "quantity": 1,
    "feature_key": "feature_job_posts"
  },
  "message": "Event received"
}