原文：http://developer.myspace.com/community/myspace/da.aspx
MySpaceIDで利用可能なRESTリソースについて
Open SocialのREST リソースについて
MySpaceIDでは現在、OpenSocialのREST仕様のPersonリソースをサポートしています。
Personリソースでは、ユーザーの情報やユーザーのフレンド・リストを取得することができます。
詳しい仕様は以下をご覧ください。
http://www.opensocial.org/Technical-Resources/opensocial-spec-v081/restful-protocol
Personリソースについて
ユーザーのデータを取得するのに、先ずはOAuthにて認証用アクセス・トークンを発行してもらう必要があります。そのトークンを使って、HTTPの署名付きGETリクエストにて、下記のURIを叩きます。
http://api.myspace.com/v2/people/@me/@self?format=json
上述のOAuth用パラメータをクエリー・ストリングまたは認証ヘッダーのどちらかに含む必要があります。
Fieldsパラメータについて
Fieldsパラメータには、取得したいフィールドを指定します。
このパラメータはオプショナルです。
複数の場合は、コンマで区切ったリストで渡します。
各フィールドのサポート状況などは以下の表をご参照ください。
Person レスポンス
person レスポンスの例は以下のとおりです。
{
"totalResults":1,
"startIndex":1,
"itemsPerPage":1,
"sorted":false,
"filtered":false
"entry":[
{
"id":"myspace.com:26000010",
"nickname":"shaka",
"profileUrl":"http:\/\/www.myspace.com\/shakasarah",
"thumbnailUrl":"http:\/\/a229.ac-
images.myspacecdn.com\/images01\/118\/s_3dcfafe8145a40fc46edacfebe7eaa94.jpg"
}
]
}
フレンド・リソース
ユーザーーのフレンドを取得するには、以下の URI に対し、GET リクエストを作成します。
http://api.myspace.com/v2/people/@me/@friends
Paging パラメーター
フレンドのコレクションにページするには、以下のパラメーターを使用できます。
- startIndex={startIndex} ：ページするフレンドのコレクションのインデックス
- count={count} ：フレンドコレクションのレコード数
フレンド・レスポンス
person のフレンド・レスポンスの例は以下のとおりです。
{
"totalResults":3,
"startIndex":1,
"itemsPerPage":6,
"sorted":false,
"filtered":false,
"entry":[
{
"id":"myspace.com:26006316","nickname":"test1118",
"thumbnailUrl":"http:\/\/x.myspacecdn.com\/images\/no_pic.gif",
"profileUrl":"http:\/\/www.myspace.com\/26006316",
"hasAppInstalled": true
},
{
"id":"myspace.com:26006319","nickname":"test1119",
"thumbnailUrl":"http:\/\/x.myspacecdn.com\/images\/no_pic.gif",
"profileUrl":"http:\/\/www.myspace.com\/26006319"
},
{
"id":"myspace.com:100531","nickname":"Jules","thumbnailUrl":"http:\/\/a57.ac-
images.myspacecdn.com\/images01\/26\/s_599e302d10a635a83a06b140e8b17310.
jpg","profileUrl":"http:\/\/www.myspace.com\/thisbitchiknow"
}],
"link":[
{
"href":"http:\/\/local-
api.myspace.com\/v2\/people\/26000010\/@friends?format=json&startindex=2&count=3",
"rel":"next"
}]
}
注記：フレンドのユーザーー ID のみが返されますので、ご注意ください。ユーザーーのフレンドの識別子のみが、レスポンスに含まれるため、fields パラメーターは、フレンドのリソースと連携しません。
発生する可能性のあるエラーレスポンス
リクエストの処理が成功した場合、レスポンスのステータスコードは200になります。しかし、レスポンスに問題が発生した場合、以下のエラーレスポンスが返却される可能性があります。
Unauthorized = 401
BadRequest = 400
NotFound = 404,
MethodNotAllowed = 405.
InternalServerError = 500