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.
Cupco
12 Nov 2021, 4:29pm
Tithers
aha! Thanks for that. Will check it out. In the meantime, how exactly does Inara 'learn' about systems? (I'm sure the info is here somewhere, but there's no harm in asking )


Inara's database is built from member player journals. Every time your journal updates, any info you have gathered updates INARA. Also, if you run EDD in the background INARA will be updated with your info in real time.
Louis1970
12 Nov 2021, 6:25pm
Cupco
Tithers
aha! Thanks for that. Will check it out. In the meantime, how exactly does Inara 'learn' about systems? (I'm sure the info is here somewhere, but there's no harm in asking )



Inara's database is built from member player journals. Every time your journal updates, any info you have gathered updates INARA. Also, if you run EDD in the background INARA will be updated with your info in real time.


Yeah... the "xxxCommanderTravel"-events... Anyway - there seems to be a difference between the systems... But I'm traveling far into the realm of speculation here. I'm sure, Artie can clarify if you ask him nicely...

o7
Artie
15 Nov 2021, 1:15pm
Yep, just to confirm, it's exactly as said - all third party tools are getting the star system information from the player journals, typically distributed via EDDN network from tools like EDMC, EDDiscovery, EDDI and similar.
When some star system is missing on Inara, it's usually caused by a fact that I do not store the entire galaxy but just star systems near inhabited spaces, having stations/carriers present and similar important star system. As the galaxy is huge, the number of star systems discovered is still growing and many of the star systems are visited once a year or even less, such limitation is preventing various troubles with performance in searches just for a cost of minor inconveniences.
Louis1970
15 Nov 2021, 2:24pm
Sounds pretty reasonable to me... Thx!
Cupco
15 Nov 2021, 6:17pm
Artie
When some star system is missing on Inara, it's usually caused by a fact that I do not store the entire galaxy but just star systems near inhabited spaces, having stations/carriers present and similar important star system. As the galaxy is huge, the number of star systems discovered is still growing and many of the star systems are visited once a year or even less, such limitation is preventing various troubles with performance in searches just for a cost of minor inconveniences.


What are the conditions for keeping a system? Is it a spherical distance around Sol? Are they deleted if they haven't been updated after a certain amount of time? I'm leaving the bubble in the interest of exploration and I'm curious to know which of my contributions are being kept. No worries for the ones that are not being kept, because I am running EDD and am updating EDSM as well. They are around 69 million systems btw.
Artie
15 Nov 2021, 6:22pm
No star systems are being deleted at the moment (I may do some pruning of the "common" star systems far in the black at some point, but it's not necessary at the moment). Currently, the conditions are set for the star systems within 1000Ly bubble around Sol, 200Ly bubble around Colonia plus any star system containing stations, fleet carriers or are somewhat notable (tourist beacons, etc.) regardless their coordinates.

Last edit: 15 Nov 2021, 6:28pm
Cupco
15 Nov 2021, 7:38pm
Thx Artie.
Tithers
16 Nov 2021, 2:09am
Yes. Very helpful. Cheers, Artie! :-)
Dommaarraa
01 Dec 2021, 7:06am
Any progress on Inara writing its own API results to EDDN ?
For years Inara rellied on EDDN, but with more people being "lazy" and just running Inara API, Inara is now very often far more uptodate than the entire EDDN network.

IMHO Time to play back all the 3rd parties who have contributed, and keep EDDN fresh
Artie
01 Dec 2021, 12:17pm
Not yet, unfortunately. I am currently still in the process of refactoring of some really old Inara parts which was a thing that I was constantly dragging behind like a ball and chain and I finally decided to do something about it, as it's a necessity for some features like multi-commander accounts. I would like to finish this first.
Banger705
07 Dec 2021, 9:12pm
where the link to elite dangerous inara companion, has i have a few friends on that are asking:?
Artie
07 Dec 2021, 9:21pm
I am not sure what is meant? There is no Inara companion app, but you can see various apps using Inara API here.
Banger705
07 Dec 2021, 9:50pm
well i use one called inara - elite dangerous companion . not an app has such but adds a shortcut to your desktop so it runs in a window straight to here.

image

Last edit: 07 Dec 2021, 9:56pm
Artie
07 Dec 2021, 10:00pm
Ah, if that's some app acting as an "envelope", I strongly discourage to use it for security reasons. But I never heard of it.

What you are probably looking for and what you have made (and just forgot about it) is running your browser in the app mode. From example, in Chrome you can do following: Open Inara > in Chrome menu select More tools > Create shortcut > here check "Open the window" and voila, a desktop shortcut with app-like Inara is there.

From the screenshot attached, it looks it may be something like that (for another browser). In any case, for the security reasons mentioned it's always best to use just the common and well tested browsers, either in the regular or the app mode as described.

Edit: It leads me to the idea that maybe I can put some button for the app mode on Inara, if that's possible to make via javascript or so. I will investigate that option, although I doubt it will be possible due security reasons.

Last edit: 07 Dec 2021, 10:14pm
Kail Astin
15 Dec 2021, 6:53pm
Artie

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.

Last edit: 15 Dec 2021, 7:28pm

Post a reply

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