Question

Question

How do I return different results for the same resource?

Details

I have been searching for some time now about the proper way to build a RESTful API. Tons of great information out there. Now I am actually trying to apply this to my website and have run into a few snags. I found a few suggestions that said to base the resources on your database as a starting point, considering your database should be structured decently. Here is my scenario:

My Site:

Here is a little information about my website and the purpose of the API

We are creating a site that allows people to play games. The API is supposed to allow other developers to build their own games and use our backend to collect user information and store it.

Scenario 1:

We have a players database that stores all player data. A developer needs to select this data based on either a user_id (person who owns the player data) or a game_id (the game that collected the data).

Resource

http://site.com/api/players

Issue:

If the developer calls my resource using GET they will receive a list of players. Since there are multiple developers using this system they must specify some ID by which to select all the players. This is where I find a problem. I want the developer to be able to specify two kinds of ID’s. They can select all players by user_id or by game_id.

1. How do you handle this?
2. Do I need two separate resources?

Answer 1

Lets say you have a controller name ‘Players’, then you’ll have 2 methods:

function user_get(){
   //get id from request and do something
}

function game_get(){
//get id from request and do something
}

now the url will look like: http://site.com/api/players/user/333, http://site.com/api/players/game/333

1. player is the controller.
2. user/game are the action

If you use phil sturgeon’s framework, you’ll do that but the url will look like:
http://site.com/api/players/user/id/333, http://site.com/api/players/game/id/333

and then you get the id using : $this->get('id');