| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

Library

Page history last edited by Ryan 14 years, 2 months ago

 

Library api should be found at /api/library. The following methods should exist.

 

GET Methods

 

/api/library.(xml|json) (formerly /api/user/rich/media/experience)

Params: user, media.

If user is not specified, the logged in user is assumed.

 

Outputs a user's experience library for a given media-type.

 

xml: <item year="1996" completions="1" moment="2007-09-28 10:03:33" last="2007-09-28 10:03:33" state="complete" level="35">

<context id="11" type="anime" image="/media/11/1/jmlji515egtsi17042yrxm7cni16my5f1">

<alias>Rurouni Kenshin</alias>

</context>

<tags>historic, 明治時代, swordplay</tags>

</item>

 

 

/api/library/segments.xml (formerly /api/experience/segments)

Params: user, context_type, context_name.

If user is not specified the logged in user is assumed.

 

Outputs a list of segments for a given context, which the user has experienced.

xml: <segment id="19" completions="1" last="2009-08-11 20:56:47" type="episode">01</segment>

 

 

/api/library/updates.xml (formerly /api/experience/updates)

Params: user [, context_type, limit, page].

If user is not specified the logged in user is assumed. Optional context-type for more specific calls. Supports paging with limit and page parameters.

 

Outputs a list of context with most recent status changes.

xml: <segment id="19" completions="1" last="2009-08-11 20:56:47" type="episode">01</segment>

 

 

/api/library/count.xml (formerly /api/user/experience/count)

Params: user

If user is not specified the logged user is assumed.

 

Outputs a list of context-types with library count for each type.

xml: <context type="adrama" count="11"/>

 

 

/api/library/states.xml (formerly /api/user/experience/states)

Params: user, media

 

Outputs a list of context-states with library count for each state, for a given media.

xml: <context type="unknown" count="7"/>

 

 

/api/library/suggested.xml

Params: threshold, input_type, output_type.

 

Outputs a list of contexts with metric suggestion data.

 

 

POST Methods

 

/api/library/update.json

Params: valid context (type=name), state [, timestamp]

State being one of ('unknown', 'complete', 'current', 'wishlisted', 'started', 'paused', 'resumed', 'dropped', 'hold', 'planned', 'marathon', 'backlog', 'subscribed').

 

/api/library/import.json (formerly /api/experience/import)

Params: context_type, map, data

 

/api/library/remove.json (formerly /api/remove/experience)

Params: valid context (type=name)

 

/api/library/segment/update.json (formerly /api/experience/status/update)

Params: valid context (type=name), segment

 

/api/library/update_rating.json

Params: valid context (type=name), rating

Rating formats:

  • #x - where #x of next highest 10s place (e.g. rating of 67 = 67/100)
  • #x/#y - where #x is less than #y (e.g. rating 5/10 )
  • Decimal places allowed up to hundreths precision in ratings (not max).
  • All ratings are stored internally in a 1000-tier system.

 

 

Other

 

 

GET: /api/library/recommendations.xml

Params: user [, media-type, page, limit]

Selected or logged in user. media-type for recommendations within a specific media. limit defaults to 20, min 5, max 50.

 

userassociations

userrecommendationsstatus

userrelativity

userrelativitytiers

userreverserecommendations

 

associate

associationremove

recommend

recommendto

reflection

removerecommend

removerelativity

reverserecommend

tag

 

Comments (0)

You don't have permission to comment on this page.