FrontPage

データAPI/食品リレーション検索(アプリ向け)

API情報

名称食品リレーション検索(アプリ向け)
APIバージョン1
認証タイプクライアント認証
URLhttps://(APIサーバー名)/api/(アクセスコード)/
MethodPOST
データ形式application/x-www-form-urlencoded

概要

指定食品と組み合わされることの多い食品を検索する

パラメーター

引数名必須内容
v1(固定)int定数必須バージョン番号
現在は1
cAz(固定)string定数必須コマンド
Az = APIを呼び出す
CategoryRFL(固定)string定数必須オペレーションカテゴリー
RFL = 食品リレーションデータ
Operationgod(固定)string定数必須オペレーション
god = GETオペレーション
AppKeyアプリケーションキーstring必須アプリケーションキーペアのアプリケーションキー
IDseed認証シードstring必須認証に使う毎回変わるランダムの文字列
IDval認証ハッシュ値hash必須sha1(アプリケーションシークレット+認証シード)の値
StructData要求食品データxml必須要求食品データ
Formatjson,yaml,xmlstring定数任意出力フォーマット指定
省略時json(またはアプリケーションキー毎に指定のフォーマット)
CharsetUTF-8,SJIS,EUC-JPstring定数任意出力文字コード指定・省略時UTF8
出力フォーマットjson,xml時は常にUTF-8

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

アップロードデータXML

データ定義XML構成

objectsetタグ: ルートノード
idタグ: 食品ID [必須]
prefixタグ: IDに 'FO' を付加するフラグ 1=on [任意]

XML例

<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>
<objectset>
	<id>FO29240fd24566d0583eace35c</id>
	<prefix>1</prefix>
</objectset>

返値

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

結果データの配列

変数名内容
objectidstring食品オブジェクトID
relatedarray食品オブジェクトIDの列挙

JSONの例

{
	"api_result":true,
	"struct":[
		{
			"objectid":"FO29240fd24566d0583eace35c",
			"related":[
				"FO602dd9eb47944ae36e71e45e",
				"FOf47edc2e462da61c2e7f6e4a",
				"FOc3571f944566d05841da4085",
				"FO3cc1bb8745d44ff97ba8c6fe",
				"FO9a58f57646c9455b3ecac928",
				"FO53e252d245d44ff7718e3607"
			]
		}
	]
}

XMLの例

<?xml version="1.0" encoding="UTF-8"?>
<response>
	<api_result>1</api_result>
	<struct>
		<item>
			<objectid>FO29240fd24566d0583eace35c</objectid>
			<related>
				<item>FO602dd9eb47944ae36e71e45e</item>
				<item>FOf47edc2e462da61c2e7f6e4a</item>
				<item>FOc3571f944566d05841da4085</item>
				<item>FO3cc1bb8745d44ff97ba8c6fe</item>
				<item>FO9a58f57646c9455b3ecac928</item>
				<item>FO53e252d245d44ff7718e3607</item>
			</related>
		</item>
	</struct>
</response>

サンプル

PHPサンプル サンプル/PHP/データAPI/食品リレーション検索(アプリ向け)

バージョン

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

Version1
Revision1
Editorwest

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