API Reference

Register

Register as an API developer and receive your API key.

Creates a new developer account. Returns an API key with the prefix mjr_live_. Verify your email to activate the key for production use.

Body application/json

Response

curl -X POST https://api.majir.shop/api/v1/developers/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Developer",
    "email": "jane@example.com",
    "company": "Acme Inc"
  }'

{
  "success": true,
  "data": {
    "developer_id": "d8f7a1b2-3c4d-5e6f-...",
    "api_key": "mjr_live_k9x2m4p7q1w3...",
    "tier": "free",
    "email_verified": false
  }
}

Verify Email

Email verification callback.

Called when the developer clicks the verification link in their email. Activates the API key for production use.

Query Parameters

Response

curl https://api.majir.shop/api/v1/developers/verify\?token\=YOUR_VERIFICATION_TOKEN

{
  "success": true,
  "data": {
    "email_verified": true,
    "message": "Email verified successfully"
  }
}

Usage Statistics

Get API key usage and rate limit status.

Returns request counts, rate limit status, and tier information for the authenticated developer.

Response

curl https://api.majir.shop/api/v1/developers/usage \
  -H "X-Majir-API-Key: mjr_live_your_key_here"

{
  "success": true,
  "data": {
    "tier": "free",
    "requests_today": 42,
    "daily_limit": 100,
    "total_requests": 1337,
    "api_key_created": "2026-03-20T10:00:00Z"
  }
}

Rotate Key

Invalidate your current API key and get a new one.

Rotates your API key. The previous key is immediately invalidated. Use this if your key is compromised.

Response

curl -X POST https://api.majir.shop/api/v1/developers/keys/rotate \
  -H "X-Majir-API-Key: mjr_live_your_key_here"

{
  "success": true,
  "data": {
    "api_key": "mjr_live_n3w_r0t4t3d_k3y...",
    "previous_key_invalidated": true
  }
}

Record Click

Track a click event for attribution.

Records a click event for attribution tracking. Use this when a user clicks on an offer or affiliate link. The click is attributed to your developer account for conversion tracking.

Body application/json

Response

curl -X POST https://api.majir.shop/api/v1/events/click \
  -H "Content-Type: application/json" \
  -H "X-Majir-API-Key: mjr_live_your_key_here" \
  -d '{
    "offer_id": "offer_abc123",
    "url": "https://merchant.example.com/deal"
  }'

{
  "success": true,
  "data": {
    "click_id": "clk_7f8a9b0c1d2e",
    "tracked": true,
    "redirect_url": "https://merchant.example.com/deal?ref=majir_clk_7f8a9b0c1d2e"
  }
}