Interplanetary

Server

Download schema

Create a shipment

POST

https://api.sh.example.com/v1

/interplanetary/shipments

Creates a new interplanetary shipment with the provided details

Create a shipment › Request Body

InterplanetaryShipment

originPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

destinationPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

Cargo · required

shippingClass

string · enum · required

Shipping speed class

Enum values:

STANDARD

EXPRESS

PRIORITY

id

string · uuid · readOnly

radiationShielding

boolean

Whether cargo needs radiation shielding

Default: true

status

string · enum · readOnly

Enum values:

SCHEDULED

LAUNCHED

IN_TRANSIT

APPROACHING

LANDED

DELIVERED

estimatedDelivery

string · date-time · readOnly

trackingNumber

string · readOnly

Quantum-entangled tracking signature emitted by the launch beacon. The full string encodes origin coordinates, warp class, customs handshake, and tamper-evident checksum.

Example: QM-ENTANGLED-7a3f9b2c4d8e1f5a6b9c2d4e8f1a3b5c7d9e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f-CHECKSUM-3f5a7b9c1d3e5f7a9b1c3d5e7f

createdAt

string · date-time · readOnly

Create a shipment › Responses

Shipment created successfully

InterplanetaryShipment

originPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

destinationPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

Cargo · required

shippingClass

string · enum · required

Shipping speed class

Enum values:

STANDARD

EXPRESS

PRIORITY

id

string · uuid · readOnly

radiationShielding

boolean

Whether cargo needs radiation shielding

Default: true

status

string · enum · readOnly

Enum values:

SCHEDULED

LAUNCHED

IN_TRANSIT

APPROACHING

LANDED

DELIVERED

estimatedDelivery

string · date-time · readOnly

trackingNumber

string · readOnly

Quantum-entangled tracking signature emitted by the launch beacon. The full string encodes origin coordinates, warp class, customs handshake, and tamper-evident checksum.

createdAt

string · date-time · readOnly

POST/interplanetary/shipments

fetch('https://api.sh.example.com/v1/interplanetary/shipments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': '<api-key>'
  },
  body: JSON.stringify({
    originPlanet: 'Earth',
    destinationPlanet: 'Mars',
    cargo: {
      weight: 2.5,
      volume: 3,
      category: 'EQUIPMENT',
      temperatureControl: {
        required: true,
        minTemp: -10,
        maxTemp: 25
      }
    },
    shippingClass: 'PRIORITY',
    radiationShielding: true
  })
})

Example Request Body

{
  "originPlanet": "Earth",
  "destinationPlanet": "Mars",
  "cargo": {
    "weight": 2.5,
    "volume": 3,
    "category": "EQUIPMENT",
    "temperatureControl": {
      "required": true,
      "minTemp": -10,
      "maxTemp": 25
    }
  },
  "shippingClass": "PRIORITY",
  "radiationShielding": true
}

json

application/json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "originPlanet": "Earth",
  "destinationPlanet": "Earth",
  "cargo": {
    "weight": 0,
    "volume": 0,
    "category": "GENERAL",
    "metadata": {
      "manufacturer": "SpaceTech Inc",
      "batchNumber": "ST-2024-001"
    },
    "safetyChecks": {
      "default": "Standard equipment check",
      "radiation": {
        "procedure": "Radiation level check",
        "frequency": "DAILY"
      }
    },
    "temperatureControl": {
      "required": true,
      "minTemp": 0,
      "maxTemp": 0
    }
  },
  "shippingClass": "STANDARD",
  "radiationShielding": true,
  "status": "SCHEDULED",
  "estimatedDelivery": "2024-08-25T15:00:00Z",
  "trackingNumber": "QM-ENTANGLED-7a3f9b2c4d8e1f5a6b9c2d4e8f1a3b5c7d9e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f-CHECKSUM-3f5a7b9c1d3e5f7a9b1c3d5e7f",
  "createdAt": "2024-08-25T15:00:00Z"
}

json

application/json

Track shipment

GET

https://api.sh.example.com/v1

/interplanetary/shipments/{trackingNumber}

Get the current status and tracking information for an interplanetary shipment

Track shipment › path Parameters

trackingNumber

string · required

Track shipment › Responses

Shipment tracking information retrieved successfully

InterplanetaryShipment

originPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

destinationPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

Cargo · required

shippingClass

string · enum · required

Shipping speed class

Enum values:

STANDARD

EXPRESS

PRIORITY

id

string · uuid · readOnly

radiationShielding

boolean

Whether cargo needs radiation shielding

Default: true

status

string · enum · readOnly

Enum values:

SCHEDULED

LAUNCHED

IN_TRANSIT

APPROACHING

LANDED

DELIVERED

estimatedDelivery

string · date-time · readOnly

trackingNumber

string · readOnly

Quantum-entangled tracking signature emitted by the launch beacon. The full string encodes origin coordinates, warp class, customs handshake, and tamper-evident checksum.

createdAt

string · date-time · readOnly

GET/interplanetary/shipments/{trackingNumber}

fetch('https://api.sh.example.com/v1/interplanetary/shipments/:trackingNumber', {
  headers: {
    'X-API-Key': '<api-key>'
  }
})

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "originPlanet": "Earth",
  "destinationPlanet": "Earth",
  "cargo": {
    "weight": 0,
    "volume": 0,
    "category": "GENERAL",
    "metadata": {
      "manufacturer": "SpaceTech Inc",
      "batchNumber": "ST-2024-001"
    },
    "safetyChecks": {
      "default": "Standard equipment check",
      "radiation": {
        "procedure": "Radiation level check",
        "frequency": "DAILY"
      }
    },
    "temperatureControl": {
      "required": true,
      "minTemp": 0,
      "maxTemp": 0
    }
  },
  "shippingClass": "STANDARD",
  "radiationShielding": true,
  "status": "SCHEDULED",
  "estimatedDelivery": "2024-08-25T15:00:00Z",
  "trackingNumber": "QM-ENTANGLED-7a3f9b2c4d8e1f5a6b9c2d4e8f1a3b5c7d9e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f-CHECKSUM-3f5a7b9c1d3e5f7a9b1c3d5e7f",
  "createdAt": "2024-08-25T15:00:00Z"
}

json

application/json

Create specialized shipment

POST

https://api.sh.example.com/v1

/interplanetary/specialized-shipments

Creates a new interplanetary shipment for specialized cargo types like cryo, quantum, or antimatter

Create specialized shipment › Request Body

originPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

destinationPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

Cargo · required

shippingClass

string · enum · required

Shipping speed class

Enum values:

STANDARD

EXPRESS

PRIORITY

id

string · uuid · readOnly

radiationShielding

boolean

Whether cargo needs radiation shielding

Default: true

status

string · enum · readOnly

Enum values:

SCHEDULED

LAUNCHED

IN_TRANSIT

APPROACHING

LANDED

DELIVERED

estimatedDelivery

string · date-time · readOnly

trackingNumber

string · readOnly

Quantum-entangled tracking signature emitted by the launch beacon. The full string encodes origin coordinates, warp class, customs handshake, and tamper-evident checksum.

createdAt

string · date-time · readOnly

Create specialized shipment › Responses

Specialized shipment created successfully

originPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

destinationPlanet

string · enum · required

Enum values:

Earth

Mars

Venus

Mercury

Jupiter

Cargo · required

shippingClass

string · enum · required

Shipping speed class

Enum values:

STANDARD

EXPRESS

PRIORITY

id

string · uuid · readOnly

radiationShielding

boolean

Whether cargo needs radiation shielding

Default: true

status

string · enum · readOnly

Enum values:

SCHEDULED

LAUNCHED

IN_TRANSIT

APPROACHING

LANDED

DELIVERED

estimatedDelivery

string · date-time · readOnly

trackingNumber

string · readOnly

Quantum-entangled tracking signature emitted by the launch beacon. The full string encodes origin coordinates, warp class, customs handshake, and tamper-evident checksum.

createdAt

string · date-time · readOnly

POST/interplanetary/specialized-shipments

fetch('https://api.sh.example.com/v1/interplanetary/specialized-shipments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': '<api-key>'
  },
  body: JSON.stringify({
    originPlanet: 'Earth',
    destinationPlanet: 'Mars',
    cargo: {
      weight: 1.5,
      volume: 2,
      category: 'HAZARDOUS',
      specialization: {
        type: 'CRYO',
        containmentLevel: 4,
        cryogenicTemp: -196.5
      }
    },
    shippingClass: 'PRIORITY',
    radiationShielding: true
  })
})

Example Request Body

{
  "originPlanet": "Earth",
  "destinationPlanet": "Mars",
  "cargo": {
    "weight": 1.5,
    "volume": 2,
    "category": "HAZARDOUS",
    "specialization": {
      "type": "CRYO",
      "containmentLevel": 4,
      "cryogenicTemp": -196.5
    }
  },
  "shippingClass": "PRIORITY",
  "radiationShielding": true
}

json

application/json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "originPlanet": "Earth",
  "destinationPlanet": "Earth",
  "cargo": {
    "weight": 0,
    "volume": 0,
    "category": "GENERAL",
    "metadata": {
      "manufacturer": "SpaceTech Inc",
      "batchNumber": "ST-2024-001"
    },
    "safetyChecks": {
      "default": "Standard equipment check",
      "radiation": {
        "procedure": "Radiation level check",
        "frequency": "DAILY"
      }
    },
    "temperatureControl": {
      "required": true,
      "minTemp": 0,
      "maxTemp": 0
    }
  },
  "shippingClass": "STANDARD",
  "radiationShielding": true,
  "status": "SCHEDULED",
  "estimatedDelivery": "2024-08-25T15:00:00Z",
  "trackingNumber": "QM-ENTANGLED-7a3f9b2c4d8e1f5a6b9c2d4e8f1a3b5c7d9e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f-CHECKSUM-3f5a7b9c1d3e5f7a9b1c3d5e7f",
  "createdAt": "2024-08-25T15:00:00Z"
}

json

application/json

Plan shipping route

POST

https://api.sh.example.com/v1

/interplanetary/route-planning

Plans a shipping route with either direct or multi-hop configuration

Plan shipping route › Request Body

ShippingRoute

routeType

string · enum · required

Enum values:

DIRECT

MULTI_HOP

required

array

Plan shipping route › Responses

Route planned successfully

ShippingRoute

routeType

string · enum · required

Enum values:

DIRECT

MULTI_HOP

required

array

POST/interplanetary/route-planning

fetch('https://api.sh.example.com/v1/interplanetary/route-planning', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': '<api-key>'
  },
  body: JSON.stringify({
    routeType: 'DIRECT',
    route: {
      direct: {
        estimatedDays: 180,
        fuelType: 'ION'
      }
    }
  })
})

Example Request Body

{
  "routeType": "DIRECT",
  "route": {
    "direct": {
      "estimatedDays": 180,
      "fuelType": "ION"
    }
  }
}

json

application/json

Example Responses

{
  "routeType": "DIRECT",
  "route": {
    "direct": {
      "estimatedDays": 1,
      "fuelType": "ION"
    }
  },
  "requirements": [
    {
      "gravitationalAssist": {
        "planet": "planet",
        "minVelocity": 0
      }
    }
  ]
}

json

application/json

Get quantum manifest

GET

https://api.sh.example.com/v1

/interplanetary/quantum-manifests/{manifestId}

Returns a quantum cargo manifest.

Get quantum manifest › path Parameters

manifestId

string · required

Manifest identifier

Get quantum manifest › Responses

200

Quantum manifest

QuantumManifest

manifestId

string · required

Unique manifest identifier

QuantumContext · required

object[] · required

List fuel stations

GET

https://api.sh.example.com/v1

/interplanetary/fuel-stations

Returns all available fuel stations along interplanetary routes

List fuel stations › query Parameters

location

string · enum

Filter by orbital location

Enum values:

Earth Orbit

Mars Orbit

Venus Orbit

Jupiter Orbit

Asteroid Belt

fuelType

string[] · style: pipeDelimited

Filter by fuel type (pipe-delimited: fuelType=ION|CHEMICAL)

Enum values:

ION

CHEMICAL

SOLAR

NUCLEAR

features

string[] · style: form

Filter by station features (comma-separated: features=REPAIR_BAY,CARGO_TRANSFER)

Enum values:

REPAIR_BAY

CARGO_TRANSFER

CREW_REST

EMERGENCY_DOCK

status

string[] · style: form · explode: true

Filter by station status (exploded: status=ACTIVE&status=MAINTENANCE)

Enum values:

ACTIVE

MAINTENANCE

DECOMMISSIONED

UNDER_CONSTRUCTION

sectors

string[] · style: spaceDelimited

Filter by space sectors (space-delimited: sectors=ALPHA%20BETA)

Enum values:

ALPHA

BETA

GAMMA

DELTA

List fuel stations › Responses

200

List of fuel stations

FuelStation[]

A fuel station along interplanetary routes

FuelStation

stationId

string · uuid · readOnly · required

Unique identifier for the fuel station

name

string · required

Name of the fuel station

location

string · enum · required

Orbital location of the station

Enum values:

Earth Orbit

Mars Orbit

Venus Orbit

Jupiter Orbit

Asteroid Belt

fuelTypes

string[]

Available fuel types at this station

Enum values:

ION

CHEMICAL

SOLAR

NUCLEAR

capacity

number

Maximum fuel capacity in metric tons

currentAvailability

number · min: 0 · max: 100

Current fuel availability percentage