Skip to content

Latest commit

 

History

History
47 lines (35 loc) · 1.35 KB

README.md

File metadata and controls

47 lines (35 loc) · 1.35 KB

igdb_client

Ruby client interface for IGDB API. Supports API v4.

Installation

$ gem install igdb_client

Usage

The structure of queries and results matches the api documentaion. You will need client id and a client secret to access the API. The above link explains how to acquire them.

Please note, that unlike the previous versions, this client takes a client secret rather than access token. The client will retrieve the required access token and renew it whenever it expires.

Instance
require 'igdb_client'

# initialize with client id and token
client = IGDB::Client.new("client_id","client_secret") 

# Endpoint can optionally be provided to change from defaults of 'games'
other_client = IGDB::Client.new("client_id","token", 'characters') 

# Endpoint/token/client_id can be changed on a client
other_client.endpoint = 'games'

# Use the get method to fetch given the API params
client.get {fields: "name", limit: 10}

# Use search method to search
client.search("ibb and obb", {fields: "name,release_dates,rating"})

# Use id if you want to match by id
client.id 1942

# You can run methods on alternate endpoints by using endpoint as method
client.character.id 14390

# Access retrieved data by using methods matching fields of data
results = client.platform.id 2
results[0].name
results[0].summary