ParcelEx API

Follow these steps to integrate the ParcelEx API:

1. Register as a merchant at /merchant/register
2. Wait for approval from the ClanCorp team (2-3 business days)
3. Contact your account manager to generate an API key
4. Use the API key in the Authorization header
5. Make your first request to calculate a shipping rate

Base URL

https:/linkfa.de/api/parcelex

All requests must use HTTPS. The API returns JSON responses.

All API requests (except tracking and locations) require authentication using an API key passed as a Bearer token:

Authorization: Bearer pk_live_your_api_key_here

API keys are generated by the ClanCorp admin team. Each key is tied to your merchant account and has a configurable rate limit.

Each API key has a configurable rate limit (default: 100 requests per minute).

When you exceed the limit, the API returns a 429 Too Many Requests response.

async function fetchWithRetry(url, options, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const res = await fetch(url, options);
    if (res.status !== 429) return res;
    await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
  }
  throw new Error('Rate limit exceeded after retries');
}

Planned events:

• shipment.created
• shipment.picked_up
• shipment.in_transit
• shipment.delivered
• shipment.failed