Developer API Overview

The Developer API provides full management access to your PackEdge resources. Use it to build automations, integrate with your platform, or create custom dashboards.

Base URL: https://api.packedge.dev/v1

Who Uses This?

You (the developer) — from your backend systems. Never expose this API to end customers.

┌─────────────────────────────────────────────────────┐
│  Your Backend / Platform                            │
│  ┌─────────────────────────────────────────────┐   │
│  │  WooCommerce, Custom CRM, Automation        │   │
│  │  ┌─────────────────────────────────────┐   │   │
│  │  │  Authorization: Bearer sk_secret... │───┼───┼──► api.packedge.dev/v1/*
│  │  │  (YOUR secret, never shared)        │   │   │
│  │  └─────────────────────────────────────┘   │   │
│  └─────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘

Use Cases

• E-commerce integration — Auto-create licenses on WooCommerce/EDD purchase
• CRM sync — Keep customer data in sync with your CRM
• Custom dashboard — Build your own analytics/management UI
• Automation — Bulk license operations, scheduled tasks

Authentication

Pass your secret API key in the Authorization header:

Authorization: Bearer sk_your_secret_key

Creating an API Key

1. Go to PackEdge Console
2. Navigate to Settings → API Keys
3. Click Create API Key
4. Copy and store securely (shown once)

Security

• Never expose API keys in client-side code, git repos, or logs
• Keys have full account access
• Rotate immediately if compromised

Endpoints

Products

• List — Get all products
• Get — Get single product
• Create — Create new product
• Update — Update product
• Delete — Delete product

Licenses

• List — Get licenses (with filters)
• Get — Get single license
• Create — Issue new license
• Update — Modify license
• Delete — Revoke license

Customers

• List — Get all customers
• Get — Get customer details
• Create — Create customer
• Update — Update customer
• Delete — Delete customer

Sites

• List — Get sites
• Get — Get site details
• Deactivate — Force deactivate

Coming Soon

• Webhooks — Manage webhook endpoints
• Invoices — Access invoice history
• Subscriptions — Manage recurring billing

Response Format

All responses are JSON:

{
  "data": { ... },
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 100,
    "totalPages": 5
  }
}

Error Handling

Errors return appropriate HTTP status codes with details:

{
  "error": "Product not found"
}

Status	Meaning
200	Success
201	Created
400	Bad request
401	Unauthorized — invalid or missing API key
404	Not found
422	Validation error
500	Server error