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.
Artie
15 Dec 2021, 9:54pm
Kail AstinArtie

An odd one. On, or shortly before, 07-Dec FDev changed my Fleet Carrier's ID from WZT-7LZ to WZT-7DZ. At one point INARA listed both FC ID's (although one was mainly blank) in the System. The old ID disappeared eventually, but after the FC left the System and returned later, INARA now seems confused as to where the FC actually is.. the mainly blank FC entry persists and INARA believes my FC is where it was, rather than where it is. I don't think it can deal with the now apparently duplicated entry for the FC.

EDDB seems OK.

Can you assist? Thanks.

edit: PS I tried a journal import, or two, to no avail.


Thanks for the report. I made some improvements, so it should be hopefully better for the next fleet carrier updates. It can be quite messy with such fleet carrier properties changes (idents, marketIDs) as there can be even contradicting information received and I cannot afford to simply remove the possibly "now old" stations, because there are users related to it and it may cause fleet carriers suddenly disappearing to them. But, I hope it will get better with the changes made.
Kail Astin
15 Dec 2021, 10:08pm
Artie.. Thanks for the report. I made some improvements, so it should be hopefully better for the next fleet carrier updates. It can be quite messy with such fleet carrier properties changes (idents, marketIDs) as there can be even contradicting information received and I cannot afford to simply remove the possibly "now old" stations, because there are users related to it and it may cause fleet carriers suddenly disappearing to them. But, I hope it will get better with the changes made.


Thanks Artie.
Athanasius
20 Jan 2022, 4:00pm
EDMC has an open issue pertaining to Inara's idea of 'total assets': https://github.com/EDCD/EDMarketConnector/issues/1401

It looks like Inara isn't using the Journal Statistics -> Bank_Account -> Current_Wealth value for this. We're only sending setCommanderCredits->commanderCredits, no commanderAssets key:value present. In my testing we're definitely sending the full Statistics data from the Journal event.
Athanasius
24 Jan 2022, 8:09pm
Having looked at EDDN and upload message compression lately it occurred to me to check if Inara's API supports that.

I can't see any mention either way on https://inara.cz/inara-api-devguide/ - and don't want to just try it and possibly find "oh it works" and then assume that's official, rather than an accident of web server configuration, and not guaranteed to continue working.

So:

1. Does (or should) the Inara API endpoint support message body compression, i.e. Content Type of gzip or deflate, and the body then gzip-format compressed ?
2. Whether it does or not, could you update the documentation to make this explicit for the benefit of all.

If the answer is yes, then we'll go ahead and implement that in EDMC's use of the Inara API, if only to be nice to players with limited upstream bandwidth.
Alysianne
24 Jan 2022, 9:15pm
Hello hello, I am an absolute rookie in terms of programming but out of curiosity I wanted to try and set up a personal ranking of certain minor factions considering a few different factors, mostly for RP purposes. I looked at what EEDB posts every evening, but the data wasn't precise enough for what I'm trying to do. I was wondering if the Inara API can be used to collect data on here and sort it into a csv according to certain criteriae, and if that is the case how it can be done (if it can be done by someone like me, with very little programming knowledge ^-^").

To be more precise the criteriae I'm looking to use are (posting them in case some pose more problems than others) :
Federal Corporate minor factions, the number of systems each faction is present in, the number each controls, their security and economic status (number of systems in civil liberty/lockdown/etc, investment/bust/etc), the number of small / medium / large pad assets each own (settlement/outpost/station/etc). Ideally also count specific states like number of inf failures, outbreaks, wars, expansions, blight, droughts.

Would this require setting up a program to sift through the data ? Or can the API directly be used to slap everything onto a spreadsheet and sort everything from there ? Any help for this hopeless noob would be greatly appreciated x)
Artie
26 Jan 2022, 3:03pm
AthanasiusHaving looked at EDDN and upload message compression lately it occurred to me to check if Inara's API supports that.
...

This one was answered via Discord, but for the other readers - uncompressed data only at the moment (I will add the mention to the documentation).

AlysianneHello hello, I am an absolute rookie in terms of programming but out of curiosity I wanted to try and set up a personal ranking of certain minor factions considering a few different factors, mostly for RP purposes. I looked at what EEDB posts every evening, but the data wasn't precise enough for what I'm trying to do. I was wondering if the Inara API can be used to collect data on here and sort it into a csv according to certain criteriae, and if that is the case how it can be done (if it can be done by someone like me, with very little programming knowledge ^-^").

To be more precise the criteriae I'm looking to use are (posting them in case some pose more problems than others) :
Federal Corporate minor factions, the number of systems each faction is present in, the number each controls, their security and economic status (number of systems in civil liberty/lockdown/etc, investment/bust/etc), the number of small / medium / large pad assets each own (settlement/outpost/station/etc). Ideally also count specific states like number of inf failures, outbreaks, wars, expansions, blight, droughts.

Would this require setting up a program to sift through the data ? Or can the API directly be used to slap everything onto a spreadsheet and sort everything from there ? Any help for this hopeless noob would be greatly appreciated x)

Hello, I have no plans for adding such stuff into Inara API, you may however try to utilize EliteBGS API to get the data for your needs.
https://elitebgs.app/ebgs/docs/V5/
MR2STEPSFROMHELL
18 Feb 2022, 9:43am
hello everyone,

could someone help me with my fleet carrier market information not showing in inara please ?
Artie
19 Feb 2022, 4:41pm
MR2STEPSFROMHELLhello everyone,

could someone help me with my fleet carrier market information not showing in inara please ?

Hello, please disable black market on your fleet carrier. Due a bug on Frontier's end, it is overriding the regular market data on their server's endpoint used for Inara updates, even when it's empty.
Gizzard
21 Feb 2022, 3:12pm
Hey folks,

Is there a problem with storage not updating? I have some mismatches between inara and upgrade items for suites and ground weapons. And manual imports don't seem to update them?
Artie
22 Feb 2022, 12:53pm
Hello,
hmmm... it seems you were discarding some items from the backpack, right? This seems like a cause of the discrepancy (I will take a look at that). In any case, relog to main menu and back to the game should write the full inventory into the journal (and should get imported with a correct state), in the worst case.
Gizzard
22 Feb 2022, 2:20pm
ArtieHello,
hmmm... it seems you were discarding some items from the backpack, right? This seems like a cause of the discrepancy (I will take a look at that). In any case, relog to main menu and back to the game should write the full inventory into the journal (and should get imported with a correct state), in the worst case.


Thanks for the reply Artie, I was making some space at one point, but even prior to that it didn't seem to be updating correctly. Will double check again today after doing the above. Thanks.
Kebabstorm
21 Mar 2022, 1:19am
Can you add one TLS1.2 cipher suite from this list TLS Cipher Suites in Windows 7 to inara.cz ? For example TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 is just as secure as TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 which is part of your server's cipher suite but not supported in Windows 7 (or Windows Server 2012) TLS stack.

Without that, none of the applications which use C#.NET HttpWebRequest (which seems to be most of them) will work.

More info in this GitHub issue: https://github.com/EDDiscovery/BaseUtilities/issues/35
Artie
21 Mar 2022, 1:15pm
Nope, please update to a newer OS (Windows 7 is no longer officially supported by MS, except the critical security updates, which will end next year anyway).
Kebabstorm
21 Mar 2022, 1:55pm
Sadly Windows 7 is the last good version of Windows where you still own your own operating system and data, and I'm not ready to completely transition to Linux just yet. You don't really need any security updates either when every service which is open to the network is disabled, a feat which is nigh impossible to achieve on later versions without breaking the OS itself because Microsoft "services" are so tightly integrated and baked in. /rant
Nygosaki
17 Apr 2022, 5:54am
Quick question. How does Inara get its commodity data?

Post a reply

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