Test & Live Modes

Hali ya Majaribio na Moja kwa Moja

Develop and test your integration safely in sandbox mode. When you're ready, switch to live mode with a simple key change. No code modifications needed.

Test Mode

mkz_test_*

Full API functionality
Listings sandboxed (invisible to users)
No rate limit charges
Test data auto-purged after 7 days
No real search visibility
No analytics data generated

Live Mode

mkz_live_*

Full API functionality
Listings visible to all users
Full search & discovery
Analytics & insights tracking
Real-time webhook events
SLA-backed uptime guarantee

Switching Modes

Simply change your API key prefix. The API behavior is identical — only visibility differs.

bash

// Test mode — listings are not visible to real users
curl -X POST https://makazi.io/api/v1/listings/bulk \
  -H "X-API-Key: mkz_test_abc123..." \
  -d '{ "listings": [...], "test_mode": true }'

// Response includes test_mode flag
{
  "summary": {
    "total": 5,
    "succeeded": 5,
    "failed": 0,
    "test_mode": true  // ← Listings are sandboxed
  }
}

Going Live Checklist

Verify all test listings were created successfully
Check error handling for validation failures
Test webhook endpoints with test events
Replace mkz_test_ with mkz_live_ in your environment
Monitor the first batch of live listings in your dashboard

Get Your API Key