tradingpost.js
v1.0.2-Beta.1
Published
API Wrapper written in JS for the SpaceTraders API
Downloads
2
Maintainers
Readme
TradingPost
TradingPost is an API wrapper for the SpaceTraders API.
Note: Due to ratelimits, the wrapper is configured to only run 2 requests per 1.5 seconds. It also only allows for one request to happen at a time. This may or may not change in the future
Events
There is two events
- ready
- error
Each can be handled like this
Ready event
// wrapper represents the TradingPost object
wrapper.on('ready', (/* no args are given in the event */) => {
console.log('Connection Established');
});
Error event
//wrapper represents the TradingPost object
wrapper.on('error', (err /* Will always be an error object*/) => {
console.log('An Error has occured');
console.log(err.stack);
});
Objects
There are many objects representing each object in the SpaceTraders Universe
- The Ship object represents a ship. This is a full ship, with an id, location, cargo and coordinates.
- The PartialShip represents a partial ship. The differences are that there is no ID or cargo, but does have a class.
- The MarketShip object represents a ship from a listing. This is the same as partial ship, but has a list of purchase locations and a list of goods that the ship is not allowed to carry.
- The Location object represents a location in a system.
- The Good object represents a good available in the game
- The Loan object represents a loan.
- The Listing object represents a market listing for a good.
- The Structure object represents a structure that can be built.
- The PartialSystem object represents a systems's basic info
- The System object represents a systems complete info. It contains a list of all of the locations in a system
- The UserFlightPlan object represents a flightplan from another user.
- The FlightPlan object represents one of your flightplans.
- The Order object represents a completed order
- The MarketOrder object represents a full market order. Containing an order object represent the good order. A ship object representing the ship that the goods went to, and the amount of credits you have left.
- The User object represents a SpaceTraders user. Currently this only represents you.
- The Jettison object represents a finished jettison request.
- The Deposit object represents a deposit into a structure.
- The Transfer object represents a transfer from one ship to another.
- The Warp Object represents a FlightPlan that ends in another system.
- The MiscData object represents random data, normally it's just a success message