RESTリクエストについて

RESTリクエストでは次の構文がサポートされています:

URI	リソース (入力)	/? または &{filter} (出力)
http://{servername}:{port}/rest/	{dataClass}	$filter, $attributes, $skip, $method=......
	{dataClass}/$entityset/{entitySetID}	$method=...
	{dataClass}({key})	$attributes
	{dataClass}:{attribute}(value)

RESTリクエストには、URI とリソースが必ず含まれていなければなりませんが、返されるデータをフィルダーする出力パラメーターの使用は任意です。

すべての URI と同様に、先頭パラメーターは "?" に続けて指定し、それ以降のパラメーターは "&" で区切ります。 例:

GET /rest/Person/?$filter="lastName!=Jones"&$method=entityset&$timeout=600

曖昧さ回避のため、値は引用符内に書くことができます。 たとえば、上の例では名字 (lastName) の値を単一引用符内に書けます: "lastName!='Jones'"。

パラメーターを利用することで、4Dプロジェクトのデータクラスのデータを操作できます。 GET HTTPメソッドを使ってデータを取得する以外にも、POST HTTPメソッドを使ってデータクラスのエンティティを追加・更新・削除することが可能です。

JSON の代わりに配列形式でデータを取得するには $asArray パラメーターを使います。

RESTステータスとレスポンス

各 RESTリクエストに対し、サーバーはステータスとレスポンス (エラー付き、またはエラー無し) を返します。

リクエストステータス

RESTリクエストをおこなうと、レスポンスとともにステータスが返されます。 主なステータスをいくつか紹介します:

ステータス	説明
0	リクエストは処理されませんでした (サーバー未起動の可能性)
200 OK	リクエストはエラーなく処理されました
401 Unauthorized	権限エラー (ユーザーのアクセス権限を確認する必要があります)
402 No session	セッションの最大数に達しています
404 Not Found	データクラスが REST に公開されていないか、エンティティが存在しません
500 Internal Server Error	RESTリクエスト処理中にエラーが発生しました

レスポンス

返されるレスポンス (JSON形式) はリクエストによって変わります。

エラーが発生した場合、その内容はレスポンスとともに返されるか、サーバーのレスポンスそのものになります。