mirror of
https://github.com/SpaceTradersAPI/api-docs.git
synced 2024-11-14 22:30:51 +01:00
- add warp endpoint
- rename ship symbol to ship type - update ship modules and engines w/ new types
This commit is contained in:
parent
19728e019c
commit
a27432248e
@ -5,10 +5,10 @@
|
|||||||
"symbol": {
|
"symbol": {
|
||||||
"type": "string",
|
"type": "string",
|
||||||
"enum": [
|
"enum": [
|
||||||
"ENGINE_IMPULSE_DRIVE",
|
"ENGINE_IMPULSE_DRIVE_I",
|
||||||
"ENGINE_ION_DRIVE_I",
|
"ENGINE_ION_DRIVE_I",
|
||||||
"ENGINE_ION_DRIVE_II",
|
"ENGINE_ION_DRIVE_II",
|
||||||
"ENGINE_HYPER_DRIVE"
|
"ENGINE_HYPER_DRIVE_I"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
"name": {
|
"name": {
|
||||||
|
@ -5,16 +5,19 @@
|
|||||||
"symbol": {
|
"symbol": {
|
||||||
"type": "string",
|
"type": "string",
|
||||||
"enum": [
|
"enum": [
|
||||||
"MODULE_MINERAL_PROCESSOR",
|
"MODULE_MINERAL_PROCESSOR_I",
|
||||||
"MODULE_CARGO_HOLD",
|
"MODULE_CARGO_HOLD_I",
|
||||||
"MODULE_CREW_QUARTERS",
|
"MODULE_CREW_QUARTERS_I",
|
||||||
"MODULE_ENVOY_QUARTERS",
|
"MODULE_ENVOY_QUARTERS_I",
|
||||||
"MODULE_PASSENGER_CABIN",
|
"MODULE_PASSENGER_CABIN_I",
|
||||||
"MODULE_MICRO_REFINERY",
|
"MODULE_MICRO_REFINERY_I",
|
||||||
"MODULE_SCIENCE_LAB",
|
"MODULE_SCIENCE_LAB_I",
|
||||||
"MODULE_JUMP_DRIVE_I",
|
"MODULE_JUMP_DRIVE_I",
|
||||||
"MODULE_JUMP_DRIVE_II",
|
"MODULE_JUMP_DRIVE_II",
|
||||||
"MODULE_JUMP_DRIVE_III",
|
"MODULE_JUMP_DRIVE_III",
|
||||||
|
"MODULE_WARP_DRIVE_I",
|
||||||
|
"MODULE_WARP_DRIVE_II",
|
||||||
|
"MODULE_WARP_DRIVE_III",
|
||||||
"MODULE_SHIELD_GENERATOR_I",
|
"MODULE_SHIELD_GENERATOR_I",
|
||||||
"MODULE_SHIELD_GENERATOR_II"
|
"MODULE_SHIELD_GENERATOR_II"
|
||||||
]
|
]
|
||||||
|
15
models/ShipType.json
Normal file
15
models/ShipType.json
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
{
|
||||||
|
"description": "",
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"SHIP_PROBE",
|
||||||
|
"SHIP_MINING_DRONE",
|
||||||
|
"SHIP_INTERCEPTOR",
|
||||||
|
"SHIP_LIGHT_HAULER",
|
||||||
|
"SHIP_COMMAND_FRIGATE",
|
||||||
|
"SHIP_EXPLORER",
|
||||||
|
"SHIP_HEAVY_FREIGHTER",
|
||||||
|
"SHIP_LIGHT_SHUTTLE",
|
||||||
|
"SHIP_ORE_HOUND"
|
||||||
|
]
|
||||||
|
}
|
@ -2,19 +2,8 @@
|
|||||||
"description": "",
|
"description": "",
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"properties": {
|
"properties": {
|
||||||
"symbol": {
|
"type": {
|
||||||
"type": "string",
|
"$ref": "./ShipType.json"
|
||||||
"enum": [
|
|
||||||
"SHIP_PROBE_SATELLITE",
|
|
||||||
"SHIP_MINING_DRONE",
|
|
||||||
"SHIP_INTERCEPTOR",
|
|
||||||
"SHIP_LIGHT_HAULER",
|
|
||||||
"SHIP_COMMAND_FRIGATE",
|
|
||||||
"SHIP_EXPLORER",
|
|
||||||
"SHIP_HEAVY_FREIGHTER",
|
|
||||||
"SHIP_LIGHT_SHUTTLE",
|
|
||||||
"SHIP_ORE_HOUND"
|
|
||||||
]
|
|
||||||
},
|
},
|
||||||
"name": {
|
"name": {
|
||||||
"type": "string"
|
"type": "string"
|
||||||
|
@ -76,17 +76,17 @@
|
|||||||
"REACTOR_FISSION_I",
|
"REACTOR_FISSION_I",
|
||||||
"REACTOR_CHEMICAL_I",
|
"REACTOR_CHEMICAL_I",
|
||||||
"REACTOR_ANTIMATTER_I",
|
"REACTOR_ANTIMATTER_I",
|
||||||
"ENGINE_IMPULSE_DRIVE",
|
"ENGINE_IMPULSE_DRIVE_I",
|
||||||
"ENGINE_ION_DRIVE_I",
|
"ENGINE_ION_DRIVE_I",
|
||||||
"ENGINE_ION_DRIVE_II",
|
"ENGINE_ION_DRIVE_II",
|
||||||
"ENGINE_HYPER_DRIVE",
|
"ENGINE_HYPER_DRIVE_I",
|
||||||
"MODULE_MINERAL_PROCESSOR",
|
"MODULE_MINERAL_PROCESSOR_I",
|
||||||
"MODULE_CARGO_HOLD",
|
"MODULE_CARGO_HOLD_I",
|
||||||
"MODULE_CREW_QUARTERS",
|
"MODULE_CREW_QUARTERS_I",
|
||||||
"MODULE_ENVOY_QUARTERS",
|
"MODULE_ENVOY_QUARTERS_I",
|
||||||
"MODULE_PASSENGER_CABIN",
|
"MODULE_PASSENGER_CABIN_I",
|
||||||
"MODULE_MICRO_REFINERY",
|
"MODULE_MICRO_REFINERY_I",
|
||||||
"MODULE_SCIENCE_LAB",
|
"MODULE_SCIENCE_LAB_I",
|
||||||
"MODULE_JUMP_DRIVE_I",
|
"MODULE_JUMP_DRIVE_I",
|
||||||
"MODULE_JUMP_DRIVE_II",
|
"MODULE_JUMP_DRIVE_II",
|
||||||
"MODULE_JUMP_DRIVE_III",
|
"MODULE_JUMP_DRIVE_III",
|
||||||
|
@ -970,9 +970,8 @@
|
|||||||
"application/json": {
|
"application/json": {
|
||||||
"schema": {
|
"schema": {
|
||||||
"properties": {
|
"properties": {
|
||||||
"shipSymbol": {
|
"shipType": {
|
||||||
"description": "The symbol of the ship you want to purchase.",
|
"$ref": "../models/ShipType.json"
|
||||||
"type": "string"
|
|
||||||
},
|
},
|
||||||
"waypointSymbol": {
|
"waypointSymbol": {
|
||||||
"description": "The symbol of the waypoint you want to purchase the ship at.",
|
"description": "The symbol of the waypoint you want to purchase the ship at.",
|
||||||
@ -980,7 +979,7 @@
|
|||||||
}
|
}
|
||||||
},
|
},
|
||||||
"required": [
|
"required": [
|
||||||
"shipSymbol",
|
"shipType",
|
||||||
"waypointSymbol"
|
"waypointSymbol"
|
||||||
],
|
],
|
||||||
"type": "object"
|
"type": "object"
|
||||||
@ -1511,7 +1510,7 @@
|
|||||||
}
|
}
|
||||||
],
|
],
|
||||||
"post": {
|
"post": {
|
||||||
"description": "Jump your ship from one system to another.",
|
"description": "Jump your ship instantly to a target system. Unlike other forms of navigation, jumping requires a unit of antimatter.",
|
||||||
"operationId": "jump-ship",
|
"operationId": "jump-ship",
|
||||||
"requestBody": {
|
"requestBody": {
|
||||||
"content": {
|
"content": {
|
||||||
@ -1588,7 +1587,7 @@
|
|||||||
}
|
}
|
||||||
],
|
],
|
||||||
"post": {
|
"post": {
|
||||||
"description": "Navigate to a target destination. The destination must be located within the same system as the ship. Navigating will consume the necessary fuel and supplies from the ship's manifest, and will pay out crew wages from the agent's account.\n\nThe returned response will detail the route information including the expected time of arrival. Most ship actions are unavailable until the ship has arrived at it's destination.\n\nFor faster-than-light travel between systems, see the ship's jump action.",
|
"description": "Navigate to a target destination. The destination must be located within the same system as the ship. Navigating will consume the necessary fuel and supplies from the ship's manifest, and will pay out crew wages from the agent's account.\n\nThe returned response will detail the route information including the expected time of arrival. Most ship actions are unavailable until the ship has arrived at it's destination.\n\nTo travel between systems, see the ship's warp or jump actions.",
|
||||||
"operationId": "navigate-ship",
|
"operationId": "navigate-ship",
|
||||||
"requestBody": {
|
"requestBody": {
|
||||||
"content": {
|
"content": {
|
||||||
@ -1653,6 +1652,83 @@
|
|||||||
]
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"/my/ships/{shipSymbol}/warp": {
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"in": "path",
|
||||||
|
"name": "shipSymbol",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"post": {
|
||||||
|
"description": "Warp your ship to a target destination in another system. Warping will consume the necessary fuel and supplies from the ship's manifest, and will pay out crew wages from the agent's account.\n\nThe returned response will detail the route information including the expected time of arrival. Most ship actions are unavailable until the ship has arrived at it's destination.",
|
||||||
|
"operationId": "warp-ship",
|
||||||
|
"requestBody": {
|
||||||
|
"content": {
|
||||||
|
"application/json": {
|
||||||
|
"schema": {
|
||||||
|
"properties": {
|
||||||
|
"waypointSymbol": {
|
||||||
|
"description": "The target destination.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"waypointSymbol"
|
||||||
|
],
|
||||||
|
"type": "object"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"description": ""
|
||||||
|
},
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"content": {
|
||||||
|
"application/json": {
|
||||||
|
"schema": {
|
||||||
|
"description": "",
|
||||||
|
"properties": {
|
||||||
|
"data": {
|
||||||
|
"properties": {
|
||||||
|
"fuel": {
|
||||||
|
"$ref": "../models/ShipFuel.json"
|
||||||
|
},
|
||||||
|
"nav": {
|
||||||
|
"$ref": "../models/ShipNav.json"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"nav",
|
||||||
|
"fuel"
|
||||||
|
],
|
||||||
|
"type": "object"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"data"
|
||||||
|
],
|
||||||
|
"type": "object"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"description": "The successful transit information including the route details and changes to ship fuel, supplies, and crew wages paid. The route includes the expected time of arrival."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"AgentToken": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"summary": "Warp Ship",
|
||||||
|
"tags": [
|
||||||
|
"fleet"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
"/my/ships/{shipSymbol}/sell": {
|
"/my/ships/{shipSymbol}/sell": {
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{
|
{
|
||||||
|
Loading…
Reference in New Issue
Block a user