How atoship Works

// Complete shipping workflow
const API_KEY = 'your_api_key';
const BASE_URL = 'https://atoship.com/api/v1';

// 1. Get rates from all carriers
const ratesResponse = await fetch(`${BASE_URL}/rates`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from: {
      name: "Your Store",
      street1: "123 Store Street",
      city: "San Francisco",
      state: "CA",
      zip: "94102"
    },
    to: {
      name: "John Customer",
      street1: "456 Customer Ave",
      city: "Los Angeles",
      state: "CA",
      zip: "90210"
    },
    parcel: {
      weight: 16,  // ounces
      length: 12,
      width: 8,
      height: 6
    }
  })
});

const { rates } = await ratesResponse.json();
// rates = [{ id, carrier, service, rate, delivery_days }, ...]

// 2. Create label with cheapest rate
const labelResponse = await fetch(`${BASE_URL}/labels`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    rate_id: rates[0].id,
    label_format: 'PDF'
  })
});

const label = await labelResponse.json();
// label = { id, tracking_number, label_url, carrier, cost }

// 3. Track the package
const trackingResponse = await fetch(
  `${BASE_URL}/tracking/${label.tracking_number}`,
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
);

const tracking = await trackingResponse.json();
// tracking = { status, events: [{ timestamp, description, location }] }