From a4a26924e5890a3801ccf788ebcea142e46b5fa3 Mon Sep 17 00:00:00 2001 From: Space Admiral Date: Wed, 9 Mar 2022 19:16:02 -0800 Subject: [PATCH] initial commit --- models/Agent.yaml | 30 + models/Contract.yaml | 103 +++ models/ContractDelivery.yaml | 36 + models/Faction.yaml | 46 ++ models/Meta.yaml | 22 + models/Ship.yaml | 121 ++++ models/Survey.yaml | 28 + reference/SpaceTraders.yaml | 1220 ++++++++++++++++++++++++++++++++++ 8 files changed, 1606 insertions(+) create mode 100644 models/Agent.yaml create mode 100644 models/Contract.yaml create mode 100644 models/ContractDelivery.yaml create mode 100644 models/Faction.yaml create mode 100644 models/Meta.yaml create mode 100644 models/Ship.yaml create mode 100644 models/Survey.yaml create mode 100644 reference/SpaceTraders.yaml diff --git a/models/Agent.yaml b/models/Agent.yaml new file mode 100644 index 0000000..0689b8e --- /dev/null +++ b/models/Agent.yaml @@ -0,0 +1,30 @@ +description: '' +type: object +x-examples: + example-1: + accountId: cl0hok34m0003ks0jjql5q8f2 + symbol: 2C52AD + headquarters: X1-OE-PM + credits: 0 +properties: + accountId: + type: string + minLength: 1 + symbol: + type: string + minLength: 1 + headquarters: + type: string + minLength: 1 + credits: + type: number +required: + - accountId + - symbol + - headquarters + - credits +examples: + - accountId: cl0hok34m0003ks0jjql5q8f2 + symbol: EMBER + headquarters: X1-OE-PM + credits: 0 diff --git a/models/Contract.yaml b/models/Contract.yaml new file mode 100644 index 0000000..fc58707 --- /dev/null +++ b/models/Contract.yaml @@ -0,0 +1,103 @@ +description: '' +type: object +properties: + id: + type: string + minLength: 1 + faction: + type: string + minLength: 1 + type: + type: string + minLength: 1 + terms: + type: object + properties: + deadline: + type: string + minLength: 1 + payment: + type: object + properties: + onAccepted: + type: number + onFulfilled: + type: number + required: + - onAccepted + - onFulfilled + deliver: + type: array + uniqueItems: true + minItems: 1 + items: + required: + - tradeSymbol + - destination + - units + - fulfilled + properties: + tradeSymbol: + type: string + minLength: 1 + destination: + type: string + minLength: 1 + units: + type: number + fulfilled: + type: number + required: + - deadline + - payment + - deliver + accepted: + type: boolean + fulfilled: + type: boolean + expiresAt: + type: string + minLength: 1 +required: + - id + - faction + - type + - terms + - accepted + - fulfilled + - expiresAt +x-examples: + example-1: + 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' +examples: + - 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' diff --git a/models/ContractDelivery.yaml b/models/ContractDelivery.yaml new file mode 100644 index 0000000..ce9e068 --- /dev/null +++ b/models/ContractDelivery.yaml @@ -0,0 +1,36 @@ +description: '' +type: object +properties: + data: + type: object + properties: + tradeSymbol: + type: string + minLength: 1 + destination: + type: string + minLength: 1 + units: + type: number + fulfilled: + type: number + required: + - tradeSymbol + - destination + - units + - fulfilled +required: + - data +x-examples: + example-1: + data: + tradeSymbol: IRON_ORE + destination: X1-OE-PM + units: 10000 + fulfilled: 500 +examples: + - data: + tradeSymbol: IRON_ORE + destination: X1-OE-PM + units: 10000 + fulfilled: 500 diff --git a/models/Faction.yaml b/models/Faction.yaml new file mode 100644 index 0000000..9fbb1ab --- /dev/null +++ b/models/Faction.yaml @@ -0,0 +1,46 @@ +description: '' +type: object +x-examples: + example-1: + 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 +examples: + - 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 +properties: + symbol: + type: string + minLength: 1 + name: + type: string + minLength: 1 + description: + type: string + minLength: 1 + headquarters: + type: string + minLength: 1 + traits: + type: array + items: + type: string +required: + - symbol + - name + - description + - headquarters + - traits diff --git a/models/Meta.yaml b/models/Meta.yaml new file mode 100644 index 0000000..bdc35fb --- /dev/null +++ b/models/Meta.yaml @@ -0,0 +1,22 @@ +description: '' +type: object +properties: + total: + type: number + page: + type: number + limit: + type: number +required: + - total + - page + - limit +x-examples: + example-1: + total: 6 + page: 1 + limit: 20 +examples: + - total: 10 + page: 1 + limit: 10 diff --git a/models/Ship.yaml b/models/Ship.yaml new file mode 100644 index 0000000..95959fb --- /dev/null +++ b/models/Ship.yaml @@ -0,0 +1,121 @@ +description: '' +type: object +x-examples: + example-1: + symbol: 2C52AD-1 + crew: null + officers: null + frame: FRAME_FRIGATE + reactor: REACTOR_FUSION_I + engine: ENGINE_ION_DRIVE_II + modules: + - MODULE_GAS_TANK + - MODULE_CARGO_HOLD + - MODULE_CARGO_HOLD + - MODULE_CREW_QUARTERS + - MODULE_ENVOY_QUARTERS + - MODULE_JUMP_DRIVE_I + mounts: + - MOUNT_SENSOR_ARRAY_II + - MOUNT_MINING_LASER_II + - MOUNT_GAS_SIPHON_II + registration: + factionSymbol: COMMERCE_REPUBLIC + agentSymbol: 2C52AD + fee: 0 + role: COMMAND + integrity: + frame: 1 + reactor: 1 + engine: 1 + status: DOCKED + location: X1-OE-PM + cargo: + - tradeSymbol: IRON_ORE + units: 100 +properties: + symbol: + type: string + minLength: 1 + frame: + type: string + minLength: 1 + reactor: + type: string + minLength: 1 + engine: + type: string + minLength: 1 + modules: + type: array + items: + type: string + mounts: + type: array + items: + type: string + registration: + type: object + required: + - factionSymbol + - agentSymbol + - fee + - role + properties: + factionSymbol: + type: string + minLength: 1 + agentSymbol: + type: string + minLength: 1 + fee: + type: number + role: + type: string + minLength: 1 + integrity: + type: object + required: + - frame + - reactor + - engine + properties: + frame: + type: number + reactor: + type: number + engine: + type: number + status: + type: string + minLength: 1 + location: + type: string + minLength: 1 + cargo: + type: array + uniqueItems: true + minItems: 1 + items: + type: object + properties: + tradeSymbol: + type: string + minLength: 1 + units: + type: number + required: + - tradeSymbol + - units +required: + - symbol + - frame + - reactor + - engine + - modules + - mounts + - registration + - integrity + - status + - location + - cargo diff --git a/models/Survey.yaml b/models/Survey.yaml new file mode 100644 index 0000000..f45910e --- /dev/null +++ b/models/Survey.yaml @@ -0,0 +1,28 @@ +description: '' +type: object +x-examples: + example-1: + signature: X1-OE-D2DD38 + deposits: + - COPPER_ORE + expiration: '2022-03-08T05:41:55.514Z' +properties: + signature: + type: string + minLength: 1 + deposits: + type: array + items: + type: string + expiration: + type: string + minLength: 1 +required: + - signature + - deposits + - expiration +examples: + - signature: X1-OE-D2DD38 + deposits: + - COPPER_ORE + expiration: '2022-03-08T05:41:55.514Z' diff --git a/reference/SpaceTraders.yaml b/reference/SpaceTraders.yaml new file mode 100644 index 0000000..a2ce6fe --- /dev/null +++ b/reference/SpaceTraders.yaml @@ -0,0 +1,1220 @@ +openapi: 3.1.0 +info: + title: SpaceTraders + version: '1.0' + summary: Documentation for the SpaceTraders API + contact: + name: Joel Brubaker + email: joel@spacetraders.io + license: + name: NONE +servers: + - url: 'http://v2-0-0.alpha.spacetraders.io' + description: v2.0.0-alpha +paths: + /agents: + post: + summary: Register as a new agent + tags: [] + responses: + '201': + description: Created + 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. + requestBody: + content: + application/json: + schema: + type: object + properties: + symbol: + type: string + faction: + type: string + /my/agent: + get: + summary: Get your agent details + tags: [] + 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 + '/my/ships/{shipSymbol}/chart': + post: + summary: Submit a system or waypoint chart + tags: [] + 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. + 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: [] + 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 + '/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: [] + 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 + '/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: [] + 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 + '/my/ships/{shipSymbol}/jettison': + parameters: + - schema: + type: string + name: shipSymbol + in: path + required: true + post: + summary: Jettison cargo from your ship + tags: [] + 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. + '/my/ships/{shipSymbol}/extract': + parameters: + - schema: + type: string + name: shipSymbol + in: path + required: true + post: + summary: Extract resources from a waypoint + tags: [] + 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. + '/my/ships/{shipSymbol}/jump': + parameters: + - schema: + type: string + name: shipSymbol + in: path + required: true + post: + summary: Jump to a new system + tags: [] + 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 + '/my/ships/{shipSymbol}/purchase': + parameters: + - schema: + type: string + name: shipSymbol + in: path + required: true + post: + summary: Purchase cargo for your ship + tags: [] + 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 + '/my/ships/{shipSymbol}/refuel': + parameters: + - schema: + type: string + name: shipSymbol + in: path + required: true + post: + summary: Refuel your ship + tags: [] + 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 + '/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: [] + 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 + 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: [] + 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. + '/my/ships/{shipSymbol}': + parameters: + - schema: + type: string + name: shipSymbol + in: path + required: true + get: + summary: View the details of your ship + tags: [] + 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. + /my/ships: + parameters: + - schema: + type: string + name: shipSymbol + in: path + required: true + get: + summary: View a list of all your ships + tags: [] + 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. +components: + schemas: {} + securitySchemes: {}