Third Party Developer Blog

Jul
13

Adding Bookmarks to the API

CCP Tellus | 2015-07-13 14:44 | Comments

Dear fans of bookmarks, I bring good tidings.

A new endpoint to the XML API is to be deployed with the Aegis Sovereignty release. So without further ado, here are the details.

Bookmarks!

Your personal and corporation bookmarks are exposed through the new endpoints char/Bookmarks.xml.aspx and corp/Bookmarks.xml.aspx respectively. Information such as name, location, creator, and creation time are exposed. For your own security and safety in space, new access masks are required for access to these endpoints. None of your existing API keys will have access to these endpoints without first updating them and explicitly granting access to bookmarks.

The new access masks are 268435456 for character and account API keys, and 67108864 for corporation keys.

Very important disclaimer! Due to the sensitive nature of this endpoint, CCP reserves the right to remove or modify this endpoint at any time, at its own discretion.

Example XML

<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="2">
  <currentTime>2015-07-08 21:42:12</currentTime>
  <result>
    <rowset name="folders" key="folderID" columns="folderName,creatorID">
      <row folderID="0" folderName="" creatorID="0">
        <rowset name="bookmarks" key="bookmarkID" columns="creatorID,created,itemID,typeID,locationID,x,y,z,memo,note">
          <row bookmarkID="12" creatorID="90000001" created="2015-07-08 21:34:14" itemID="60014689" typeID="57" locationID="30004971" x="0" y="0" z="0" memo="Home Station" note="Our base of residence" />
          <row bookmarkID="13" creatorID="90000001" created="2015-07-08 21:35:07" itemID="40314792" typeID="8" locationID="30004971" x="0" y="0" z="0" memo="Sun" note="" />
        </rowset>
      </row>
      <row folderID="1" folderName="A lovely empty folder" creatorID="90000001">
        <rowset name="bookmarks" key="bookmarkID" columns="creatorID,created,itemID,typeID,locationID,x,y,z,memo,note" />
      </row>
      <row folderID="3" folderName="Sites" creatorID="90000001">
        <rowset name="bookmarks" key="bookmarkID" columns="creatorID,created,itemID,typeID,locationID,x,y,z,memo,note">
          <row bookmarkID="16" creatorID="90000001" created="2015-07-08 21:37:12" itemID="40314827" typeID="15" locationID="30004971" x="0" y="0" z="0" memo="Duripant VII - Asteroid Belt 2 ( Asteroid Belt )" note="" />
          <row bookmarkID="17" creatorID="90000001" created="2015-07-08 21:37:22" itemID="40314829" typeID="15" locationID="30004971" x="0" y="0" z="0" memo="Duripant VII - Asteroid Belt 3 ( Asteroid Belt )" note="" />
          <row bookmarkID="18" creatorID="90000001" created="2015-07-08 21:37:29" itemID="40314794" typeID="15" locationID="30004971" x="0" y="0" z="0" memo="Duripant I - Asteroid Belt 1 ( Asteroid Belt )" note="" />
          <row bookmarkID="19" creatorID="90000001" created="2015-07-08 21:37:39" itemID="40314811" typeID="15" locationID="30004971" x="0" y="0" z="0" memo="Duripant VII - Asteroid Belt 1 ( Asteroid Belt )" note="" />
        </rowset>
      </row>
      <row folderID="4" folderName="Random crap" creatorID="90000001">
        <rowset name="bookmarks" key="bookmarkID" columns="creatorID,created,itemID,typeID,locationID,x,y,z,memo,note">
          <row bookmarkID="14" creatorID="90000001" created="2015-07-08 21:36:08" itemID="0" typeID="5" locationID="30004971" x="-373405654941.733" y="42718621667.0746" z="-1415023302173.46" memo="spot in Duripant solar system" note="" />
          <row bookmarkID="15" creatorID="90000001" created="2015-07-08 21:36:46" itemID="0" typeID="5" locationID="30004971" x="-373405652840.03" y="42718623812.4957" z="-1415023308332.07" memo="spot in Duripant solar system" note="" />
        </rowset>
      </row>
    </rowset>
  </result>
  <cachedUntil>2015-07-08 22:42:12</cachedUntil>
</eveapi>

~~ CCP Tellus

back