Inara API

More about Inara API is on the API page, general dev guidelines are here and more detailed documentation about the events and data format here.

Just a note for tool authors using Inara API - please ensure your apps are doing  TWO requests per minute AT MAXIMUM. As I have discovered, many users are using multiple apps at once (nothing wrong with that), but are also updating their profiles from all of the applications at once, which is causing quite serious overhead. For such reason, I have needed to make API requests limits much tighter. For bots and other similar non-demanding apps are requests rates set same as before. If do you need another requests rate limit, please send me a PM.

Inara API update for Odyssey:
  • The header property isDeveloped was renamed to less confusing isBeingDeveloped. You don't need to change anything on your end though, the old property will still work.
  • A new event addCommanderTravelLand for commanders landing on the celestial body was added (should be triggered at journal's Touchdown, DropShipDeploy and similar).
  • The events addCommanderTravelCarrierJump, addCommanderTravelDock, addCommanderTravelFSDJump and setCommanderTravelLocation now contain optional properties for the star system coordinates, celestial body and celestial body coordinates. It's not required to set, it may however help to further precise commander's location when the star system is not in the database, etc.
  • The events addCommanderTravelDock, addCommanderTravelFSDJump and addCommanderTravelLand are now having boolean properties isTaxiShuttle and isTaxiDropship for travelling with Apex or Frontline Solutions ships.
  • New events setCommanderInventory, resetCommanderInventory, setCommanderInventoryItem, addCommanderInventoryItem and delCommanderInventoryItem added. Those are supposed for handling the new Odyssey events like ShipLockerMaterials and similar, you can however use it also for the existing engineering materials or ship cargo instead of the existing dedicated events (but you do not need to, they are not going anywhere).
  • New events setCommanderSuitLoadout, updateCommanderSuitLoadout and delCommanderSuitLoadout for the suit loadouts added.
SuperFixxxeR
27 Jun 2023, 1:38pm
Much appreciated, thanks for the speedy response. Must be in a Mamba!
Sethellion Tam
03 Jul 2023, 1:18pm
Hello there my friends. I am currently still content with playing my console version of ED on my PS5 and accompanying large TV (wonderful when looking for just the right asteroid colors xD) but in dealing with Frontier over the last few days when I discovered I somehow have 3 accounts (two of which have no commander data or ARX and one that's attached to my PSN commander records and ARX logs), I was informed there is a split in the player base now due to Console users being on Legacy and all other uses being up to speed.

I am assuming this is why Inara has been incapable of grabbing my Commander data from Frontier servers when I try and do an import.

My question here is, I am realizing when I go to a station or system to sell commodities in Solo Mode, there are variances between the prices I am seeing in game versus ones I see here updated to Inara even when within an hour or less. Are these variances due to discrepancies between the split in Legacy / Current versions of the world? Because now my game world is only being affected by other console players and not the greater community here on Inara?

So far I haven't had TOO many issues and the variances are quite low enough or I was able to find alternate stations to sell to for profit on return mining trips, but now that I know there's a difference I am wondering what all that effects.

My gaming Laptop can probably handle ED considering its age, but I am not yet keen to switch yet. I'd like to get all my ships purchased and engineers unlocked before making the swap.
Artie
03 Jul 2023, 9:20pm
Hello,
yes, the Legacy and Live galaxies are completely independent since game update 14 (deployed in late 2022) and as a vast majority of players are playing the Live game version and due to the multiple issues with maintaining Legacy data (a lack of updates, various technical requirements, etc.) Inara is now supporting only the Live game version. So although some relatively static data may be still somewhat on par with the Legacy galaxy, in most cases it will be off (like the market data, minor faction influences, fleet carriers, etc.).

As the Legacy game version is no longer developed by Frontier, the best course of action is to simply transfer the console game account via the official Frontier's portal (you will get a free PC game copy, too) and continue playing on PC. There can be also utilized some streaming service like Geforce Now for playing, in case your laptop won't handle it.
Sethellion Tam
04 Jul 2023, 12:11am
ArtieHello,
yes, the Legacy and Live galaxies are completely independent since game update 14 (deployed in late 2022) and as a vast majority of players are playing the Live game version and due to the multiple issues with maintaining Legacy data (a lack of updates, various technical requirements, etc.) Inara is now supporting only the Live game version. So although some relatively static data may be still somewhat on par with the Legacy galaxy, in most cases it will be off (like the market data, minor faction influences, fleet carriers, etc.).

As the Legacy game version is no longer developed by Frontier, the best course of action is to simply transfer the console game account via the official Frontier's portal (you will get a free PC game copy, too) and continue playing on PC. There can be also utilized some streaming service like Geforce Now for playing, in case your laptop won't handle it.



Is there a way to filter or reasonably know what data could be taken as 'static' ? Until I switch over later. (I am just dreading having to reprogram for controller functionality since I don't have a whole joycon setup though hopefully Steam already has player submitted controler schemes that match. I assume I CAN play this on steam...?)

And in the migration process to PC, what is maintained and lost in the switch as far as data is concerned?
Artie
04 Jul 2023, 1:19am
Almost everything is transferred, more details about the console transfer are here.
By "relatively static" I mean stuff like shipyards, outfitting, general commodities availability at stations (but not their prices), there shouldn't be big differences although some discrepancies are possible. Plus star systems and stations, of course.
Sethellion Tam
04 Jul 2023, 1:21am
You have been a considerable help, thank you so much.
Mizen21
01 Aug 2023, 4:18pm
I have an opinion about updating data with APIs, such as in E:D Market Connector.

Is it possible for the API developers to collaborate with the game creators to create one or multiple IDs (to avoid getting banned) that would simulate docking at different stations by pulling only the specific data that indicates "[This ship (with this ID) docked at this station]"? This would allow simulating docking without actually having to dock the ship, and thus updating the fresh data for that station into the API system. Additionally, it could loop through all or sequential station names (if feasible) with a set loop interval of every 30 minutes or 1 hour, for example.

If this can be achieved, we would have new live data every 30 minutes without missing or skipping stations for an extended period. Moreover, it would be friendly to both new and old players. Please consider this suggestion.
Artie
01 Aug 2023, 4:30pm
Well, it doesn't need to be that complicated, such API will simply need to have an endpoint for getting the station market prices that can be requested (without a need to simulate ships docking, etc.). But, this is solely a decision of Frontier (as it's something they must provide on their server) and as far as I remember, this is not something they are planning to do (at least not anytime soon). It would be nice, of course, but I understand why they aren't willing to do so.
SuperFixxxeR
09 Aug 2023, 10:26am
Greetings Artie,

A quick question about the getCommanderProfile event.

I've noticed, Inara users who have changed their name may get a response like this;

"events": [
{
"eventStatus": 200,
"eventData": {
"userID": 221296,
"userName": "Coco l'asticot",
"commanderName": "Steven Gift",

<snip>

Am I correct to assume that userName is permanent, and commanderName is whatever that cmdr's name is on Inara at the current time?
Artie
09 Aug 2023, 11:00am
SuperFixxxeRGreetings Artie,

A quick question about the getCommanderProfile event.

I've noticed, Inara users who have changed their name may get a response like this;


"events": [
{
"eventStatus": 200,
"eventData": {
"userID": 221296,
"userName": "Coco l'asticot",
"commanderName": "Steven Gift",


<snip>

Am I correct to assume that userName is permanent, and commanderName is whatever that cmdr's name is on Inara at the current time?

The userName is a name used on Inara (account/profile/user name), the commanderName is a name in the game. Both can change, either because the user will change it in Inara settings (userName) or in the game via the FDev support or link their new game account and so on. If you want some permanent identifier then you can use the userID, that is not changing.
SuperFixxxeR
09 Aug 2023, 11:21am
Many thanks as always Artie for your comprehensive response o7
STAFKE
27 Sep 2023, 5:01pm
Hello, this is my first time using Inara for my elite adventures.

Sadly I am having troubles setting it up so that my in game info is connected to Inara.
I have downloaded ED connector, connected it and authorised it, it correctly shows my exact location ingame.

I have setup a account here in Inara , connected it with my account and updated it, it shows correct information.

Now I filled in the Inara API key in ED connector and pressed ok.

for a test I am looking for Agronomic treatment commodity, in my game the closest station with this commodity is ivanchenkov enterprise ross 775 (i am in ackerman market) which is 58 ly away.
according to INARA it is 21,89 ly away, which is still the same as it was when I didnt have anything setup , so im wondering what I did wrong or maybe I forgot a step in setup process?

greetings , Staf
Artie
28 Sep 2023, 12:00pm
STAFKEHello, this is my first time using Inara for my elite adventures.

Sadly I am having troubles setting it up so that my in game info is connected to Inara.
I have downloaded ED connector, connected it and authorised it, it correctly shows my exact location ingame.

I have setup a account here in Inara , connected it with my account and updated it, it shows correct information.

Now I filled in the Inara API key in ED connector and pressed ok.

for a test I am looking for Agronomic treatment commodity, in my game the closest station with this commodity is ivanchenkov enterprise ross 775 (i am in ackerman market) which is 58 ly away.
according to INARA it is 21,89 ly away, which is still the same as it was when I didnt have anything setup , so im wondering what I did wrong or maybe I forgot a step in setup process?

greetings , Staf

Hello, it depends when EDMC sent an update about your current location and also, if you didn't override the location in the search form. It takes the newest information for it, so for example if EDMC will report you are in Sol at T+0, then you set the location in the form to Anlave at T+1 it will stay set to Anlave, until EDMC will provide an information you are still in Sol at T+2 (then the form will set the location as Sol again). I guess it's something that will be "resolved" on its own during regular use.
Hamurd
19 Oct 2023, 4:28pm
How do I get my carrier location to update on Inara? I have ED Market Connector, and I import data on my Commander page. Everything else updates fine, except my carriers location. I put stuff for sale on the Bartender, it updates immediately, but still shows my carrier in the wrong system.

To the point if you look at my flight log, it shows me jump to Ehlanda (where my carrier actually is) and then it shows me Docking at my carrier... in Kao Wanga!
GoldenPSP
10 Dec 2023, 5:21pm
Hey all,
I'm trying to troubleshoot an issue with inara updates. I currently use EDMC for updates and verified my API is correct. If i look under my settings I can see API updates with events logged, no errors, soft errors or warnings. However some data doesn't seem to be updating and I don't know where the hangup is.

Two key areas, Inara shows a squadron that I haven't been a member of in forever, and does not show the current squadron I'm a member of. Also while it seems to show my FC current market info, when I test by searching I don't see my FC showing up in search results for buy and sell orders. I do have my privacy settings set to EVERYONE for all categories.

Post a reply

You must be signed in to post here.
Inara API is... well... see sticky post for the details.