Developer Hub

const trackShipment = async (trackingNumber) => {
  const response = await fetch(
    `https://api.velocityultra.co.za/v2/track/${trackingNumber}`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    }
  );
  
  const data = await response.json();
  return data;
};

import requests

# Create a shipment
url = "https://api.velocityultra.co.za/v2/shipments"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

data = {
    "service": "express_ultra",
    "pickup": {
        "name": "John Doe",
        "address": "123 Main St, Johannesburg",
        "phone": "+27111234567"
    },
    "delivery": {
        "name": "Jane Smith",
        "address": "456 Oak Ave, Cape Town",
        "phone": "+27111234568"
    },
    "package": {
        "weight": 2.5,
        "dimensions": "30x20x10",
        "description": "Important documents"
    }
}

response = requests.post(url, json=data, headers=headers)
shipment = response.json()

const express = require('express');
const app = express();

app.post('/webhooks/shipment', async (req, res) => {
  const event = req.body;
  
  // Verify webhook signature
  const signature = req.headers['velocity-signature'];
  const isValid = verifySignature(signature, event);
  
  if (!isValid) {
    return res.status(400).send('Invalid signature');
  }
  
  // Handle different event types
  switch (event.type) {
    case 'shipment.created':
      console.log('New shipment:', event.data);
      break;
    case 'shipment.delivered':
      console.log('Shipment delivered:', event.data);
      break;
    case 'tracking.updated':
      console.log('Tracking update:', event.data);
      break;
  }
  
  res.status(200).send('OK');
});