mirror of
https://github.com/SpaceTradersAPI/api-docs.git
synced 2024-11-15 06:40:51 +01:00
1636 lines
56 KiB
YAML
1636 lines
56 KiB
YAML
openapi: 3.1.0
|
|
info:
|
|
title: SpaceTraders API
|
|
version: 2.0.0-alpha
|
|
summary: SpaceTraders is a unique multiplayer game built on a free Web API.
|
|
contact:
|
|
name: Joel Brubaker
|
|
email: joel@spacetraders.io
|
|
license:
|
|
name: 'No'
|
|
url: 'https://choosealicense.com/no-permission/'
|
|
description: |-
|
|
SpaceTraders is a unique multiplayer game built on a free Web API. You control a fleets of ships that can explore the universe, mine asteroids, automate trade routes, meet new factions, and discover hidden technology.
|
|
|
|
Participate in one of our regular competitive seasons or build a client to share with the community.
|
|
|
|
SpaceTraders is currently in an alpha stage of development. Join our Discord to learn more.
|
|
|
|
```json http
|
|
{
|
|
"method": "GET",
|
|
"url": "https://v2-0-0.alpha.spacetraders.io/status",
|
|
}
|
|
```
|
|
servers:
|
|
- url: 'https://v2-0-0.alpha.spacetraders.io'
|
|
description: v2.0.0-alpha
|
|
paths:
|
|
/agents:
|
|
post:
|
|
summary: Register a new agent
|
|
tags:
|
|
- agents
|
|
responses:
|
|
'201':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
token:
|
|
type: string
|
|
agent:
|
|
$ref: ../models/Agent.yaml
|
|
faction:
|
|
$ref: ../models/Faction.yaml
|
|
contract:
|
|
$ref: ../models/Contract.yaml
|
|
ship:
|
|
$ref: ../models/Ship.yaml
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
token: string
|
|
agent:
|
|
accountId: cl0hok34m0003ks0jjql5q8f2
|
|
symbol: EMBER
|
|
headquarters: X1-OE-PM
|
|
credits: 0
|
|
faction:
|
|
symbol: COMMERCE_REPUBLIC
|
|
name: Commerce Repubic
|
|
description: The Commerce Republic takes capital from top tier worlds and invests it into new systems with high potential for growth.
|
|
headquarters: X1-OE-PM
|
|
traits:
|
|
- BUREAUCRATIC
|
|
- CAPITALISTIC
|
|
- GUILD
|
|
- ESTABLISHED
|
|
contract:
|
|
id: cl0hok38t0014ks0jnoy8o5vh
|
|
faction: COMMERCE_REPUBLIC
|
|
type: PROCUREMENT
|
|
terms:
|
|
deadline: '2022-03-11T05:16:59.113Z'
|
|
payment:
|
|
onAccepted: 20000
|
|
onFulfilled: 100000
|
|
deliver:
|
|
- tradeSymbol: IRON_ORE
|
|
destination: X1-OE-PM
|
|
units: 10000
|
|
fulfilled: 0
|
|
accepted: false
|
|
fulfilled: false
|
|
expiresAt: '2022-03-09T05:16:59.112Z'
|
|
ship:
|
|
symbol: string
|
|
frame: string
|
|
reactor: string
|
|
engine: string
|
|
modules:
|
|
- string
|
|
mounts:
|
|
- string
|
|
registration:
|
|
factionSymbol: string
|
|
agentSymbol: string
|
|
fee: 0
|
|
role: string
|
|
integrity:
|
|
frame: 0
|
|
reactor: 0
|
|
engine: 0
|
|
status: string
|
|
location: string
|
|
cargo:
|
|
- tradeSymbol: string
|
|
units: 0
|
|
operationId: post-agents
|
|
description: |-
|
|
Creates a new agent and ties it to a temporary Account. Use `COMMERCE_REPUBLIC` as your starting faction if you don't know any other factions to choose from.
|
|
|
|
The agent symbol is a 4-8 character string that will represent your agent. This symbol will prefix the symbol of every ship you own. Agent symbols will be cast to all uppercase characters.
|
|
|
|
A new agent will be granted an authorization token, a contract with their starting faction, a command ship with a jump drive, and one hundred thousand credits.
|
|
|
|
> #### Keep your token safe and secure
|
|
>
|
|
> Save your token during the alpha phase. There is no way to regenerate this token without starting a new agent. In the future you will be able to generate and manage your tokens from the SpaceTraders website.
|
|
|
|
You can accept your contract using the `/my/contracts/{contractId}/accept` endpoint. You will want to navigate your command ship to a nearby asteroid field waypoint, and execute the `/my/ships/{shipSymbol}/accept` endpoint to mine various types of ores and minerals.
|
|
|
|
Return to the contract destination and execute the `/my/ships/{shipSymbol}/deliver` endpoint to deposit goods into the contract.
|
|
|
|
When your contract is fulfilled, you can call `/my/contracts/{contractId}/fulfill` to retrieve payment.
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
symbol:
|
|
type: string
|
|
description: How other agents will see your ships and information.
|
|
minLength: 4
|
|
maxLength: 8
|
|
example: BADGER
|
|
faction:
|
|
type: string
|
|
default: COMMERCE_REPUBLIC
|
|
description: The faction you choose determines your headquarters.
|
|
description: ''
|
|
/my/agent:
|
|
get:
|
|
summary: Get your agent details
|
|
tags:
|
|
- agents
|
|
- my
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
data:
|
|
$ref: ../models/Agent.yaml
|
|
examples:
|
|
Agent:
|
|
value:
|
|
data:
|
|
accountId: cl0hok34m0003ks0jjql5q8f2
|
|
symbol: EMBER
|
|
headquarters: X1-OE-PM
|
|
credits: 0
|
|
operationId: get-my-agent
|
|
security:
|
|
- AgentToken: []
|
|
description: Fetch your agent's details.
|
|
'/my/ships/{shipSymbol}/chart':
|
|
post:
|
|
summary: Submit a system or waypoint chart
|
|
tags:
|
|
- my
|
|
- ships
|
|
- chart
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
submitted:
|
|
type: array
|
|
items:
|
|
type: string
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
submitted:
|
|
- X1-ZZ
|
|
- X1-ZZ-7-EE
|
|
operationId: 'post-my-ships-:shipSymbol-chart'
|
|
description: Chart a new system or waypoint.
|
|
security:
|
|
- AgentToken: []
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
description: The symbol of the ship
|
|
'/my/ships/{shipSymbol}/deliver':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
description: The symbol of the ship
|
|
post:
|
|
summary: Deliver goods on a contract
|
|
tags:
|
|
- contracts
|
|
- my
|
|
- ships
|
|
- deliver
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
tradeSymbol: IRON_ORE
|
|
destination: X1-OE-PM
|
|
units: 10000
|
|
fulfilled: -30000
|
|
properties:
|
|
data:
|
|
$ref: ../models/ContractDelivery.yaml
|
|
required:
|
|
- data
|
|
operationId: post-my-ships-shipSymbol-deliver
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/dock':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
description: The symbol of the ship
|
|
post:
|
|
summary: Dock your ship
|
|
tags:
|
|
- my
|
|
- ships
|
|
- dock
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
required:
|
|
- status
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
status: DOCKED
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
status: DOCKED
|
|
operationId: post-my-ships-shipSymbol-dock
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/orbit':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
description: The symbol of the ship
|
|
post:
|
|
summary: Transition your ship into orbit
|
|
tags:
|
|
- my
|
|
- ships
|
|
- orbit
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
status: ORBIT
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
required:
|
|
- data
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
status: ORBIT
|
|
operationId: post-my-ships-shipSymbol-orbit
|
|
security:
|
|
- AgentToken: []
|
|
description: Transition your ship from docked into orbit. Ships are placed into orbit by default when arriving at a destination. Consecutive calls to this endpoint will continue to return a 200 response status.
|
|
'/my/ships/{shipSymbol}/jettison':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
post:
|
|
summary: Jettison cargo from your ship
|
|
tags:
|
|
- my
|
|
- ships
|
|
- jettison
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
tradeSymbol:
|
|
type: string
|
|
minLength: 1
|
|
units:
|
|
type: number
|
|
required:
|
|
- tradeSymbol
|
|
- units
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
tradeSymbol: ALUMINUM
|
|
units: 95
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
tradeSymbol: ALUMINUM
|
|
units: 95
|
|
operationId: post-my-ships-shipSymbol-jettison
|
|
description: Jettison cargo from your ship's cargo hold.
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/extract':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
description: The ship symbol
|
|
post:
|
|
summary: Extract resources from a waypoint
|
|
tags:
|
|
- extract
|
|
- mining
|
|
- my
|
|
- ships
|
|
- survey
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
shipSymbol:
|
|
type: string
|
|
minLength: 1
|
|
cooldown:
|
|
type: number
|
|
yield:
|
|
type: object
|
|
properties:
|
|
tradeSymbol:
|
|
type: string
|
|
minLength: 1
|
|
units:
|
|
type: number
|
|
required:
|
|
- tradeSymbol
|
|
- units
|
|
required:
|
|
- shipSymbol
|
|
- cooldown
|
|
- yield
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
shipSymbol: 054A8F-1
|
|
cooldown: 30
|
|
yield:
|
|
tradeSymbol: SILICON
|
|
units: 14
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
shipSymbol: 054A8F-1
|
|
cooldown: 30
|
|
yield:
|
|
tradeSymbol: IRON_ORE
|
|
units: 14
|
|
operationId: post-my-ships-shipSymbol-extract
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
survey:
|
|
$ref: ../models/Survey.yaml
|
|
description: Extract resources from the waypoint into your ship. Send a survey as the payload to target specific yields.
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/jump':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
post:
|
|
summary: Jump to a new system
|
|
tags:
|
|
- jump
|
|
- my
|
|
- ships
|
|
- navigation
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
shipSymbol:
|
|
type: string
|
|
minLength: 1
|
|
destination:
|
|
type: string
|
|
minLength: 1
|
|
cooldown:
|
|
type: number
|
|
required:
|
|
- shipSymbol
|
|
- destination
|
|
- cooldown
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
shipSymbol: CE392B-1
|
|
destination: 0b1802ba-da4d-4308-aefb-1e5065f98a53
|
|
cooldown: 43200
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
shipSymbol: CE392B-1
|
|
destination: 0b1802ba-da4d-4308-aefb-1e5065f98a53
|
|
cooldown: 43200
|
|
operationId: post-my-ships-shipSymbol-jump
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/purchase':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
post:
|
|
summary: Purchase cargo for your ship
|
|
tags:
|
|
- markets
|
|
- my
|
|
- purchase
|
|
- ships
|
|
- trade
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
waypointSymbol:
|
|
type: string
|
|
minLength: 1
|
|
tradeSymbol:
|
|
type: string
|
|
minLength: 1
|
|
credits:
|
|
type: number
|
|
units:
|
|
type: number
|
|
required:
|
|
- waypointSymbol
|
|
- tradeSymbol
|
|
- credits
|
|
- units
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
waypointSymbol: X1-OE-PM
|
|
tradeSymbol: MICROPROCESSORS
|
|
credits: -843
|
|
units: 1
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
waypointSymbol: X1-OE-PM
|
|
tradeSymbol: MICROPROCESSORS
|
|
credits: -843
|
|
units: 1
|
|
operationId: post-my-ships-shipSymbol-purchase
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/refuel':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
post:
|
|
summary: Refuel your ship
|
|
tags:
|
|
- my
|
|
- ships
|
|
- refuel
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
credits:
|
|
type: number
|
|
fuel:
|
|
type: number
|
|
required:
|
|
- credits
|
|
- fuel
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
credits: 0
|
|
fuel: 0
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
credits: -1920
|
|
fuel: 800
|
|
operationId: post-my-ships-shipSymbol-refuel
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/scan':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
post:
|
|
summary: Scan approaching or departing ships from your location
|
|
tags:
|
|
- my
|
|
- ships
|
|
- scan
|
|
responses:
|
|
'201':
|
|
description: Created
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
ships:
|
|
type: array
|
|
uniqueItems: true
|
|
minItems: 1
|
|
items:
|
|
required:
|
|
- symbol
|
|
- frameSymbol
|
|
- reactorSymbol
|
|
- engineSymbol
|
|
- expiration
|
|
properties:
|
|
symbol:
|
|
type: string
|
|
minLength: 1
|
|
registration:
|
|
type: object
|
|
properties:
|
|
factionSymbol:
|
|
type: string
|
|
minLength: 1
|
|
role:
|
|
type: string
|
|
minLength: 1
|
|
required:
|
|
- factionSymbol
|
|
- role
|
|
frameSymbol:
|
|
type: string
|
|
minLength: 1
|
|
reactorSymbol:
|
|
type: string
|
|
minLength: 1
|
|
engineSymbol:
|
|
type: string
|
|
minLength: 1
|
|
expiration:
|
|
type: string
|
|
minLength: 1
|
|
cooldown:
|
|
type: number
|
|
required:
|
|
- ships
|
|
- cooldown
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
ships:
|
|
- symbol: COMMERCE_REPUBLIC-0060A0
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
role: EXCAVATOR
|
|
frameSymbol: FRAME_HEAVY_FREIGHTER
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:20:14.725Z'
|
|
- symbol: ZANZIBAR_TRIKES-DF0AAF
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: HAULER
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:20:00.725Z'
|
|
- symbol: ZANZIBAR_TRIKES-9B80BE
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: TRANSPORT
|
|
frameSymbol: FRAME_TRANSPORT
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:20:06.725Z'
|
|
- symbol: COMMERCE_REPUBLIC-117520
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
role: HARVESTER
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:19:55.725Z'
|
|
- symbol: SPACERS_GUILD-609AA5
|
|
registration:
|
|
factionSymbol: SPACERS_GUILD
|
|
role: HAULER
|
|
frameSymbol: FRAME_FRIGATE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:19:38.725Z'
|
|
- symbol: MINERS_COLLECTIVE-7AD322
|
|
registration:
|
|
factionSymbol: MINERS_COLLECTIVE
|
|
role: EXCAVATOR
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:19:11.725Z'
|
|
- symbol: ZANZIBAR_TRIKES-AE6D78
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: HAULER
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:20:44.725Z'
|
|
- symbol: SPACERS_GUILD-92828B
|
|
registration:
|
|
factionSymbol: SPACERS_GUILD
|
|
role: SURVEYOR
|
|
frameSymbol: FRAME_LIGHT_FREIGHTER
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:20:49.726Z'
|
|
- symbol: ZANZIBAR_TRIKES-B5EAD1
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: TRANSPORT
|
|
frameSymbol: FRAME_TRANSPORT
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:20:25.726Z'
|
|
- symbol: ZANZIBAR_TRIKES-6A4E0D
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: HAULER
|
|
frameSymbol: FRAME_EXPLORER
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:19:19.726Z'
|
|
cooldown: 60
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
ships:
|
|
- symbol: COMMERCE_REPUBLIC-0060A0
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
role: EXCAVATOR
|
|
frameSymbol: FRAME_HEAVY_FREIGHTER
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:20:14.725Z'
|
|
- symbol: ZANZIBAR_TRIKES-DF0AAF
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: HAULER
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:20:00.725Z'
|
|
- symbol: ZANZIBAR_TRIKES-9B80BE
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: TRANSPORT
|
|
frameSymbol: FRAME_TRANSPORT
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:20:06.725Z'
|
|
- symbol: COMMERCE_REPUBLIC-117520
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
role: HARVESTER
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:19:55.725Z'
|
|
- symbol: SPACERS_GUILD-609AA5
|
|
registration:
|
|
factionSymbol: SPACERS_GUILD
|
|
role: HAULER
|
|
frameSymbol: FRAME_FRIGATE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:19:38.725Z'
|
|
- symbol: MINERS_COLLECTIVE-7AD322
|
|
registration:
|
|
factionSymbol: MINERS_COLLECTIVE
|
|
role: EXCAVATOR
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:19:11.725Z'
|
|
- symbol: ZANZIBAR_TRIKES-AE6D78
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: HAULER
|
|
frameSymbol: FRAME_SHUTTLE
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:20:44.725Z'
|
|
- symbol: SPACERS_GUILD-92828B
|
|
registration:
|
|
factionSymbol: SPACERS_GUILD
|
|
role: SURVEYOR
|
|
frameSymbol: FRAME_LIGHT_FREIGHTER
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:20:49.726Z'
|
|
- symbol: ZANZIBAR_TRIKES-B5EAD1
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: TRANSPORT
|
|
frameSymbol: FRAME_TRANSPORT
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_I
|
|
expiration: '2022-03-08T05:20:25.726Z'
|
|
- symbol: ZANZIBAR_TRIKES-6A4E0D
|
|
registration:
|
|
factionSymbol: ZANZIBAR_TRIKES
|
|
role: HAULER
|
|
frameSymbol: FRAME_EXPLORER
|
|
reactorSymbol: REACTOR_FUSION_I
|
|
engineSymbol: ENGINE_ION_DRIVE_II
|
|
expiration: '2022-03-08T05:19:19.726Z'
|
|
cooldown: 60
|
|
operationId: post-my-ships-shipSymbol-scan
|
|
security:
|
|
- AgentToken: []
|
|
description: Scan approaching or departing ships.
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
mode:
|
|
type: string
|
|
required:
|
|
- mode
|
|
examples:
|
|
Approaching Ships:
|
|
value:
|
|
mode: APPROACHING_SHIPS
|
|
Departing Ships:
|
|
value:
|
|
mode: APPROACHING_SHIPS
|
|
description: ''
|
|
'/my/ships/{shipSymbol}/sell':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
post:
|
|
summary: Sell cargo from your ship
|
|
tags:
|
|
- markets
|
|
- my
|
|
- sell
|
|
- ships
|
|
- trade
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
waypointSymbol:
|
|
type: string
|
|
minLength: 1
|
|
tradeSymbol:
|
|
type: string
|
|
minLength: 1
|
|
credits:
|
|
type: number
|
|
units:
|
|
type: number
|
|
required:
|
|
- waypointSymbol
|
|
- tradeSymbol
|
|
- credits
|
|
- units
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
waypointSymbol: X1-OE-PM
|
|
tradeSymbol: SILICON
|
|
credits: 144
|
|
units: -1
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
waypointSymbol: X1-OE-PM
|
|
tradeSymbol: SILICON
|
|
credits: 144
|
|
units: -1
|
|
operationId: post-my-ships-shipSymbol-sell
|
|
description: Sell cargo from your ship's hold to the local market.
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
get:
|
|
summary: View the details of your ship
|
|
tags:
|
|
- my
|
|
- ships
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
symbol: 653298-1
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
properties:
|
|
data:
|
|
$ref: ../models/Ship.yaml
|
|
required:
|
|
- data
|
|
operationId: get-my-ships-shipSymbol
|
|
description: Retrieve the details of your ship.
|
|
security:
|
|
- AgentToken: []
|
|
/my/ships:
|
|
get:
|
|
summary: View a list of all your ships
|
|
tags:
|
|
- my
|
|
- ships
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
- symbol: 653298-1
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-2
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-3
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-4
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-5
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-6
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
meta:
|
|
total: 6
|
|
page: 1
|
|
limit: 20
|
|
properties:
|
|
data:
|
|
type: array
|
|
uniqueItems: true
|
|
minItems: 1
|
|
items:
|
|
$ref: ../models/Ship.yaml
|
|
meta:
|
|
$ref: ../models/Meta.yaml
|
|
required:
|
|
- data
|
|
- meta
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
- symbol: 653298-1
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-2
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-3
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-4
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-5
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
- symbol: 653298-6
|
|
crew: null
|
|
officers: null
|
|
frame: FRAME_DRONE
|
|
reactor: REACTOR_SOLAR_I
|
|
engine: ENGINE_SOLAR_PROPULSION
|
|
modules:
|
|
- MODULE_CARGO_HOLD
|
|
mounts:
|
|
- MOUNT_MINING_LASER_I
|
|
registration:
|
|
factionSymbol: COMMERCE_REPUBLIC
|
|
agentSymbol: '653298'
|
|
fee: 100
|
|
role: EXCAVATOR
|
|
integrity:
|
|
frame: 1
|
|
reactor: 1
|
|
engine: 1
|
|
status: DOCKED
|
|
location: X1-OE-PM
|
|
cargo: []
|
|
meta:
|
|
total: 6
|
|
page: 1
|
|
limit: 20
|
|
operationId: get-my-ships
|
|
description: Retrieve all of your ships.
|
|
security:
|
|
- AgentToken: []
|
|
'/systems/{systemSymbol}':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
default: X1-OE
|
|
name: systemSymbol
|
|
in: path
|
|
required: true
|
|
description: The system symbol
|
|
get:
|
|
summary: Fetch a system
|
|
tags: []
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
symbol:
|
|
type: string
|
|
minLength: 1
|
|
sector:
|
|
type: string
|
|
minLength: 1
|
|
type:
|
|
type: string
|
|
minLength: 1
|
|
x:
|
|
type: number
|
|
'y':
|
|
type: number
|
|
waypoints:
|
|
type: array
|
|
items:
|
|
required: []
|
|
properties: {}
|
|
factions:
|
|
type: array
|
|
items:
|
|
required: []
|
|
properties: {}
|
|
charted:
|
|
type: boolean
|
|
chartedBy: {}
|
|
required:
|
|
- symbol
|
|
- sector
|
|
- type
|
|
- x
|
|
- 'y'
|
|
- waypoints
|
|
- factions
|
|
- charted
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
symbol: X1-ZZ
|
|
sector: X1
|
|
type: BLUE_STAR
|
|
x: -2
|
|
'y': 9
|
|
waypoints: []
|
|
factions: []
|
|
charted: false
|
|
chartedBy: null
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
symbol: X1-ZZ
|
|
sector: X1
|
|
type: BLUE_STAR
|
|
x: -2
|
|
'y': 9
|
|
waypoints: []
|
|
factions: []
|
|
charted: false
|
|
chartedBy: null
|
|
operationId: get-systems-systemSymbol
|
|
security:
|
|
- AgentToken: []
|
|
/systems:
|
|
get:
|
|
summary: List all systems
|
|
tags:
|
|
- systems
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
- symbol: X1-OE
|
|
sector: X1
|
|
type: RED_STAR
|
|
x: 0
|
|
'y': 0
|
|
waypoints:
|
|
- X1-OE-PM
|
|
- X1-OE-PM01
|
|
- X1-OE-A005
|
|
- X1-OE-25X
|
|
factions:
|
|
- COMMERCE_REPUBLIC
|
|
- MINERS_COLLECTIVE
|
|
- SPACERS_GUILD
|
|
charted: true
|
|
chartedBy: null
|
|
- symbol: X1-EV
|
|
sector: X1
|
|
type: ORANGE_STAR
|
|
x: 3
|
|
'y': 4
|
|
waypoints:
|
|
- X1-EV-A004
|
|
factions:
|
|
- COMMERCE_REPUBLIC
|
|
charted: true
|
|
chartedBy: null
|
|
- symbol: X1-ZZ
|
|
sector: X1
|
|
type: BLUE_STAR
|
|
x: -2
|
|
'y': 11
|
|
waypoints: []
|
|
factions: []
|
|
charted: false
|
|
chartedBy: null
|
|
meta:
|
|
total: 3
|
|
page: 1
|
|
limit: 20
|
|
properties:
|
|
data:
|
|
type: array
|
|
uniqueItems: true
|
|
minItems: 1
|
|
items:
|
|
$ref: ../models/System.yaml
|
|
meta:
|
|
type: object
|
|
required:
|
|
- total
|
|
- page
|
|
- limit
|
|
properties:
|
|
total:
|
|
type: number
|
|
page:
|
|
type: number
|
|
limit:
|
|
type: number
|
|
required:
|
|
- data
|
|
- meta
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
- symbol: X1-OE
|
|
sector: X1
|
|
type: RED_STAR
|
|
x: 0
|
|
'y': 0
|
|
waypoints:
|
|
- X1-OE-PM
|
|
- X1-OE-PM01
|
|
- X1-OE-A005
|
|
- X1-OE-25X
|
|
factions:
|
|
- COMMERCE_REPUBLIC
|
|
- MINERS_COLLECTIVE
|
|
- SPACERS_GUILD
|
|
charted: true
|
|
chartedBy: null
|
|
meta:
|
|
total: 0
|
|
page: 0
|
|
limit: 0
|
|
operationId: get-systems
|
|
description: Return a list of all systems.
|
|
security:
|
|
- AgentToken: []
|
|
'/my/ships/{shipSymbol}/navigate':
|
|
parameters:
|
|
- schema:
|
|
type: string
|
|
name: shipSymbol
|
|
in: path
|
|
required: true
|
|
description: The ship symbol
|
|
post:
|
|
summary: Navigate ship
|
|
tags: []
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
description: ''
|
|
type: object
|
|
properties:
|
|
data:
|
|
type: object
|
|
properties:
|
|
shipSymbol:
|
|
type: string
|
|
minLength: 1
|
|
departure:
|
|
type: string
|
|
minLength: 1
|
|
destination:
|
|
type: string
|
|
minLength: 1
|
|
durationRemaining:
|
|
type: number
|
|
arrivedAt: {}
|
|
required:
|
|
- shipSymbol
|
|
- departure
|
|
- destination
|
|
- durationRemaining
|
|
required:
|
|
- data
|
|
x-examples:
|
|
example-1:
|
|
data:
|
|
shipSymbol: 3AE434-1
|
|
departure: X1-OE-PM
|
|
destination: X1-OE-A005
|
|
durationRemaining: 2159
|
|
arrivedAt: null
|
|
examples:
|
|
Success:
|
|
value:
|
|
data:
|
|
shipSymbol: 3AE434-1
|
|
departure: X1-OE-PM
|
|
destination: X1-OE-A005
|
|
durationRemaining: 2159
|
|
arrivedAt: null
|
|
operationId: post-my-ships-shipSymbol-navigate
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
destination:
|
|
type: string
|
|
description: The waypoint symbol to navigate to.
|
|
get:
|
|
summary: ''
|
|
operationId: get-my-ships-shipSymbol-navigate
|
|
responses:
|
|
'200':
|
|
description: OK
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties: {}
|
|
description: Get the status of your last navigation.
|
|
security:
|
|
- AgentToken: []
|
|
tags:
|
|
- name: my
|
|
- name: ships
|
|
- name: markets
|
|
- name: trade
|
|
- name: sell
|
|
- name: purchase
|
|
- name: navigation
|
|
- name: agents
|
|
- name: dock
|
|
- name: orbit
|
|
- name: jettison
|
|
- name: jump
|
|
- name: refuel
|
|
- name: scan
|
|
- name: contracts
|
|
- name: chart
|
|
- name: extract
|
|
- name: mining
|
|
- name: deliver
|
|
- name: survey
|
|
- name: systems
|
|
- name: waypoints
|
|
components:
|
|
schemas: {}
|
|
securitySchemes:
|
|
AgentToken:
|
|
type: http
|
|
scheme: bearer
|
|
description: When you register a new agent you will be granted a private bearer token which grants authorization to use the API.
|