查询

GET /api/v4/{object_name}/

此接口用于查询业务数据,其中 {object_name} 需替换为业务对象名称。

接口只会返回当前用户授权访问的业务数据。

请求参数#

请求参数在 URL 中传入。

\$select#

指定要返回的字段及顺序。 如果不指定\$select,返回业务对象的所有列。

\$filter#

指定数据的查询条件,可以使用括号表示分组。

以下列出 odata query 支持的运算符。

时间值的必须使用以下格式:2010-07-15T16:19:54Z。

\$orderby#

确定使用哪些值对数据进行排序。 默认情况下,顺序为升序。使用 desc 使顺序反向或使用 asc 显式设置默认值。

例如,若要按修改时间逆序排序,请使用查询 \$orderby=modified desc

\$skip#

设置在返回数据前要跳过的记录数。

\$top#

设置要返回的最大记录数。

\$expand#

设置需要扩展返回的相关记录,只有 lookup 或 master/detail 类型的字段,可以使用\$expand 功能。

\$count#

在结果中返回符合查询条件的记录总数。

返回结果#

返回数组。

示例#

查询联系人(contacts)的数据,并展开对应的单位(account)信息。

curl \
-X GET http://localhost:5000/api/v4/contacts/?$top=50&$select=name,account,email,phone,owner,company_id,locked&$expand=account&$count=true \
-H 'Content-Type: application/json' \
-b 'X-Space-Token=55090bbe52...aXpwo'

响应

{
"@odata.context": "http://localhost:5000/api/v4/$metadata#contacts",
"@odata.count": 2,
"value": [
{
"@odata.id": "http://localhost:5000/api/v4/contacts('K6xNbprvtbpsdj2Jf')",
"@odata.etag": "W/\"K6xNbprvtbpsdj2Jf\"",
"@odata.editLink": "http://localhost:5000/api/v4/contacts('K6xNbprvtbpsdj2Jf')",
"_id": "K6xNbprvtbpsdj2Jf",
"name": "庄建国",
"account": {
"_id": "S9GvFQnr4zFeo3Tip",
"name": "上海华炎软件科技有限公司",
"reference_to.o": "accounts",
"_NAME_FIELD_VALUE": "上海华炎软件科技有限公司"
},
"owner": "5194c66ef4a563537a000003",
"phone": "021-37693151",
"email": "zhuangjianguo@hotoa.com"
},
{
"@odata.id": "http://localhost:5000/api/v4/contacts('9KwhPD6moaLR9YXL2')",
"@odata.etag": "W/\"9KwhPD6moaLR9YXL2\"",
"@odata.editLink": "http://localhost:5000/api/v4/contacts('9KwhPD6moaLR9YXL2')",
"_id": "9KwhPD6moaLR9YXL2",
"name": "田骐",
"account": {
"_id": "S9GvFQnr4zFeo3Tip",
"name": "上海华炎软件科技有限公司",
"reference_to.o": "accounts",
"_NAME_FIELD_VALUE": "上海华炎软件科技有限公司"
},
"email": "tianqi@hotoa.com",
"phone": "021-37693156",
"owner": "5194c66ef4a563537a000003"
}
]
}
华炎魔方

华炎魔方基于商业智能和模型驱动,即使是不懂编程的业务人员,也能轻松便捷地创建智能化、移动化的企业应用。

© 2020 华炎软件. 保留所有权利.

开发人员微信群
商务咨询
微信公众号