[[FrontPage]]
&size(24){ユーザーAPI/写真のライブラリ保存};
* API情報 [#q6190828]
|~名称|写真のライブラリ保存|
|~APIバージョン|1|
|~認証タイプ|ユーザー認証|
|~URL|https://(APIサーバー名)/services/api/(アクセスコード)/|
|~Method|POST|
|~データ形式|multipart/form-data|
* 概要 [#jfe13a2c]
写真データをユーザーピクチャーライブラリに保存する
* パラメーター [#ya59d11f]
|引数名|値|型|必須|内容|h
|v|1(固定)|int定数|必須|バージョン番号&br;現在は1|
|c|Bu(固定)|string定数|必須|コマンド&br;Bu = ユーザー認証付きBBAPIを呼び出す|
|Category|UPL(固定)|string定数|必須|オペレーションカテゴリー&br;UPL = ユーザーピクチャーライブラリ|
|Operation|poo(固定)|string定数|必須|オペレーション&br;poo = PUTオペレーション|
|AppKey|アプリケーションキー|string|必須|アプリケーションキーペアのアプリケーションキー|
|UserAuth|ユーザー認証タイプ|string|必須|userhashbb|
|uid|モバイルダイエットID|string|uidまたはloginidのいずれか必須|ユーザーのモバイルダイエットID|
|loginid|ログインID|string|uidまたはloginidのいずれか必須|ユーザーのログインID|
|password|パスワードハッシュ値|hash|必須|sha1(アプリケーションシークレット+パスワード) の値|
|StructData|アップロードデータ|xml|必須|アップロードする写真データの情報|
|Pict(uploadid)|画像データ|binary|必須|XML中で指定されたアップロードデータ&br;1ファイルは最大で2Mバイトまで&br;(uploadid)部分は任意の文字列であってXML中で指定&br;|
|Format|json,yaml,xml|string定数|任意|出力フォーマット指定&br;省略時json(またはアプリケーションキー毎に指定のフォーマット)|
|Charset|UTF-8,SJIS,EUC-JP|string定数|任意|出力文字コード指定・省略時UTF8&br;出力フォーマットjson,xml時は常にUTF-8|
認証パラメーターAppKey,UserAuth,uid,passwordについては、[[API認証>API認証#authtype_user]]を参照~
出力指定パラメーターFormat,Charsetについては、[[出力フォーマット]]を参照~
* アップロードデータXML [#d1118dc6]
** データ定義XML構成 [#sbcdc85d]
pictsetタグ: ルートノード
pictタグ: 1処理セッションの写真データ [最低でも1つは必須]
(以下pictの中に配置可能)
pictobjectタグ: 写真オブジェクト [最低でも1つは必須]
(以下pictobjectの中に配置可能)
typeタグ: 写真タイプ 0固定 [必須]
dateタグ: アップロード日時 [必須]
uploadidタグ: multipart/form-dataの画像データを含むパートのパラメータ名 [必須]
uploadhashタグ: アップロードする画像データのsha1ハッシュ値 [必須]
** XML例 [#g9ecbe25]
#html{{
<pre class="brush:xml;">
}}
#htmlinsert(samxml_mobadaiapi_userpictlib_put.xml)
#html{{
</pre>
}}
* 返値 [#e86e04c1]
|変数名|型|内容|h
|api_result|boolean|API実行結果&br;true:成功 false:失敗|
|category|string|実行されたカテゴリー名 RGP固定|
|registed|integer|受信された写真数|
|struct|array|結果データの配列|
結果データの配列
|変数名|型|内容|h
|uploadid|string|写真のアップロード識別ID|
|result|boolean|処理結果|
|objectid|string|ピクチャーライブラリオブジェクトID|
|xml|string|結果食事データ|
** JSONの例 [#a81f6668]
#html{{
<pre class="brush:xml;">
{
"api_result":true,
"api_rescode":1,
"registed":1,
"struct":[
{
"uploadid":"1395700396",
"result":true,
"objectid":"Kv4LQ0EfDlv6jspofKlv2lS1"
}
]
}
</pre>
}}
** XMLの例 [#a81f6668]
#html{{
<pre class="brush:xml;">
<?xml version="1.0" encoding="UTF-8"?>
<response>
<api_result>1</api_result>
<api_rescode>1</api_rescode>
<registed>1</registed>
<struct>
<item>
<uploadid>1395700550</uploadid>
<result>1</result>
<objectid>HAhdoB0gDH0AfBMt6O8Z3vWg</objectid>
</item>
</struct>
</response>
</pre>
}}
* サンプル [#z5db7844]
PHPサンプル [[サンプル/PHP/ユーザーAPI/写真のライブラリ保存]] &br;
* バージョン [#o0becc47]
このドキュメントのバージョン情報
|Version|1|
|Revision|1|
|Editor|west|