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
14 Nov 2018, 12:40pm
A new stuff for the Inara API

Changelog for the game update 3.3:
  • New: commanderFrontierID property in the header. This property (FID) is also present in the game 3.3 journals, so please add it to InAPI request headers as users may use it for protection against wrong updates when multiple accounts are used.
  • New: addCommanderFriend and delCommanderFriend events for adding/removing commanders to/from the friends list.
  • New: setCommanderReputationMinorFaction event for setting the commander's reputation with a minor faction.
  • Improvement: Events setCommanderRankPilot, SetCommanderRankEngineer, SetCommanderReputationMajorFaction and SetCommanderReputationMinorFaction can now contain an array of parameters (see input JSON examples) to set multiple ranks/reputations at once. But, you can also set it one by one in individual events same as before, if that's your preference.
API/Journals - worth to be mentioned:
  • EngineerProgress event is now present on the journal/session start and contains the reputation with ALL engineers, under the "Engineers" property. Please process it and set the engineer's reputation at the session start for InAPI updates as well.
  • It's now possible to correctly set 'isHot' property for all modules in the ship loadout (setCommanderShipLoadout), as this value is now present in the journals
  • The journal's Cargo event is now present throughout the session, but contains a valid list of commodities just on the session start. Please handle that properly. Also, there was/will be a new property "Vessel" added to this journal event, so it worth to send the cargo list just when set to the "Ship" value.
Artie
18 Nov 2018, 1:48pm
Just one thing I've forgot to mention - getCommanderProfile now returns squadron-related properties with different name ("squadron" instead of "wing). But, the old properties are kept there as well, for the backward compatibility. Change it to a new names when possible, but there is no need to hurry, it will remain here for a while...
Garud
21 Nov 2018, 1:50pm
Is it possible to get the internal id for system, faction, station through an API call?
Kietrax
14 Dec 2018, 2:29pm
Quick question about the API - I submit data to Inara via EDMC now but have used the journal import in the past. It looks like the "Current Assets value is read differently via these two methods - differing by about 1.2B credits in my case. Is this likely to be an API ting or an EDMC thing?
Artie
14 Dec 2018, 3:54pm
It depends - Inara API does no recalculation of the values sent - what is received is also written. But, when no overall assets value is sent at all, Inara calculates the value by actual credits and value of all ships and modules stored. It seems to be the case - EDMC sent no overall assets value, so Inara did a calculation based on your stuff, to have at least something. As I see most of your ships have a zero value, it's the cause of such huge discrepancy. The only solution is to have all the ship values properly set or to have EDMC sending overall assets value. Both things are outside my control.
Kietrax
14 Dec 2018, 7:05pm
Cheers Artie - that makes sense. I gather the way to "fix" that for EDMC is to cycle though switching to each ship in turn. I can probably do most of those over the weekend. Since the overall asset value is there though I'll ping the EDMC folks to see why it isn't sent as well. Many thanks for all the work you do here - much appreciated!
Welder Smurf
28 Dec 2018, 1:08am
I have it running in the background but its not updating...what can i do to fix this?
John Kozak
28 Dec 2018, 7:26am
Is there a way to browse the new minor faction reputation uploaded via API?

Nevermind - it's on the bottom of https://inara.cz/cmdr-reputation/ and on the minor faction screens themselves.

Would be awesome to have a screen with all of your minor faction relations though

Last edit: 28 Dec 2018, 5:33pm
Bulman
28 Dec 2018, 10:59am
Welder SmurfI have it running in the background but its not updating...what can i do to fix this?


According to Github, it was released at 03:43 UTC (maybe after your post). I've not been running it recently (I'm over 14Kly out on a spiral arm, and soon to turn for home) but when I started it this morning, it autoupdated. So, try closing it and re-starting.
Welder Smurf
01 Jan 2019, 1:52am
Bulman
Welder SmurfI have it running in the background but its not updating...what can i do to fix this?



According to Github, it was released at 03:43 UTC (maybe after your post). I've not been running it recently (I'm over 14Kly out on a spiral arm, and soon to turn for home) but when I started it this morning, it autoupdated. So, try closing it and re-starting.


Yep it's been fixed but thank you.
Dez
05 Jan 2019, 5:25pm
ArtiePlease place anything you would like to discuss, technical problems, questions about API, etc. right here...


hi is there a way to make the app get your data for the xbox one version of the game.
thanks
Artie
06 Jan 2019, 1:00pm
Hello,
not at the moment, but there will be a way how to update at least some data soon.
John Kozak
09 Jan 2019, 7:09am
PSA to EliteLogAgent users: EDDN has released an unannounced change which blacklists several influence-related fields added in 3.3. I have released a patch version 0.9.6 to deal with it, but versions 0.9.5 and below won't be able to update faction influence. It is strongly recommended to update to latest version (release notes)

Also has a feature to add INARA friends automatically

Last edit: 09 Jan 2019, 7:38am
DROPS_BOMS
23 Jan 2019, 12:35am
A massive thank you from myself and I'm sure other fellow console players

all the best cmdr Drops Boms o7
Artie
23 Jan 2019, 1:17am
Thank you, I am glad you like it.

Post a reply

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