FrontPage

ユーザーAPI/食事の一覧取得

API情報

名称食事の一覧取得
APIバージョン1
認証タイプユーザー認証
URLhttps://(APIサーバー名)/services/api/(アクセスコード)/
MethodPOST
データ形式application/x-www-form-urlencoded

概要

食事データの一覧を取得する。

パラメーター

引数名必須内容
v1(固定)int定数必須バージョン番号
現在は1
cBu(固定)string定数必須コマンド
Bu = ユーザー認証付きBBAPIを呼び出す
CategoryUM(固定)string定数必須オペレーションカテゴリー
UM = ユーザー食事データ
Operationgsl(固定)string定数必須オペレーション
gsl = GETSUMMARYLISTオペレーション
AppKeyアプリケーションキーstring必須アプリケーションキーペアのアプリケーションキー
UserAuthユーザー認証タイプstring必須userhashbb
uidモバイルダイエットIDstringuidまたはloginidのいずれか必須ユーザーのモバイルダイエットID
loginidログインIDstringuidまたはloginidのいずれか必須ユーザーのログインID
passwordパスワードハッシュ値hash必須sha1(アプリケーションシークレット+パスワード) の値
StructDataアップロードデータxml必須検索クエリーデータ
Formatjson,yaml,xmlstring定数任意出力フォーマット指定
省略時json(またはアプリケーションキー毎に指定のフォーマット)
CharsetUTF-8,SJIS,EUC-JPstring定数任意出力文字コード指定・省略時UTF8
出力フォーマットjson,xml時は常にUTF-8

認証パラメーターAppKey,UserAuth,uid,passwordについては、API認証を参照
出力指定パラメーターFormat,Charsetについては、出力フォーマットを参照

アップロードデータXML

データ定義XML構成

QuerySetタグ: ルートノード
qtypeタグ: クエリータイプ UserMealLog固定 [必須]
startdateタグ: 取得開始日時 [必須]
enddateタグ: 取得終了日時 [必須]
detailタグ: 詳細データ取得フラグ [任意]

XML例

<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>
<QuerySet>
  <qtype>UserMealLog</qtype>
  <startdate>2013/12/11 00:00:00</startdate>
  <enddate>2014/01/10 00:00:00</enddate>
  <detail>0</detail>
</QuerySet>

返値

変数名内容
api_resultbooleanAPI実行結果
true:成功 false:失敗
structarray結果データの配列

結果データの配列

変数名内容
useridstringユーザーID
mealidstring食事ID
hashkeyhash食事のハッシュ値
mealarray(詳細フラグONの時) 食事の情報
foodarray(詳細フラグONの時) 食事に含まれる食品の情報

JSONの例

{
	"api_result":true,
	"struct":[
		{
			"mealid":"M27c7eae252f4384e8cd3",
			"hashkey":"8575b6e13437287e8d30851753b7e3e39d69da5c"
		},
		{
			"mealid":"M27c7eae252f43960abb6",
			"hashkey":"110c1bc0121902ae5ad74027c114a415ac68e1c9"
		},
		{
			"mealid":"M27c7eae252f43a8fa3de",
			"hashkey":"436b52bbbaad8a193b720e40f90021d029bdc350"
		},
		{
			"mealid":"M27c7eae252f43ab43aee",
			"hashkey":"24eb337d8e95fef7a60f6b2e31d7f32a463a433b"
		},
		{
			"mealid":"M27c7eae252f43c91ee40",
			"hashkey":"a41469fec63e78a71356df92c447c758f3896ecf"
		}
	]
}

XMLの例

<?xml version="1.0" encoding="UTF-8"?>
  <response>
    <api_result>1</api_result>
    <struct>
      <item>
        <mealid>M27c7eae252f4384e8cd3</mealid>
        <hashkey>8575b6e13437287e8d30851753b7e3e39d69da5c</hashkey>
      </item>
      <item>
        <mealid>M27c7eae252f43960abb6</mealid>
        <hashkey>110c1bc0121902ae5ad74027c114a415ac68e1c9</hashkey>
      </item>
      <item>
        <mealid>M27c7eae252f43c91ee40</mealid>
        <hashkey>a41469fec63e78a71356df92c447c758f3896ecf</hashkey>
      </item>
    </struct>
  </response>

サンプル

PHPサンプル サンプル/PHP/ユーザーAPI/食事の一覧取得

バージョン

このドキュメントのバージョン情報

Version1
Revision1
Editorwest

トップ   差分 履歴 リロード   一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2018-06-22 (金) 07:59:52