Library

Game libraries are used to track the inventory of games used at Convention, usually for free checkout. Librarys are accessed via /api/library.

Properties

See "Object Properties" in Introduction for basic shared properties.

Complete details in LibraryProperties.

Related Objects

See "Related Objects" in Introduction for how to use them.

geolocation

The GeoLocation that this library calls home.

user

The User that owns this library.

Relationships

See "Relationships" in Introduction for how to use them.

checkouts

The history of LibraryGameCheckouts for a game.

Qualifiers

is_checked_in

enter_in_play_to_win

win_play_to_win

conventions

Conventions that have used this library.

librarygames

Games contained within this library.

Queryable

name

catalog_number

Qualifiers

catalog_number

is_in_circulation

is_play_to_win

is_checked_out

due_for_triage

playtowins

The PlayToWins associated with this library.

Services

The services used to fetch and manipulate libraries.

Search Libraries

This will search across all libraries.

 GET /api/library

Optional Params

query

Searches a partial name.

Returns:

 {
    "paging" : {...},
    "items" : [
        {
          "id" : "xxx",
          "name" : "Gulf Coast Library",
          ...
        },
        ...
    ]
 }

Create Library

 POST /api/library

Required Params

geolocation_id

name

email_address

Returns the same as a normal read.

Read Library

 GET /api/library/xxx

Returns:

 {
   "id" : "xxx",
   "name" : "Gulf Coast Library",
   ...
 }

Update Library

 PUT /api/library/xxx

Returns the same as a normal read.

Delete Library

 DELETE /api/library/xxx

Returns:

 {
   "success" : 1
 }

Import from Board Game Geek

This imports a game collection from a user on Board Game Geek.

 POST /api/library/xxx/import/bgg

Required Params

bgg_username

The username of the user who's collection you'd like to import into this library. Calling this service just starts the process. It will continue in the background and email the library owner when complete.

Returns:

  {
    "success" : 1
  }