3.2. JSON 响应格式
以 JSON 格式调用 API 返回结果。API 调用返回单一选项响应或响应集合的结果。
3.2.1. 单个对象的 JSON 响应格式 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
您可以使用单对象 JSON 响应来处理单个对象。对单个对象的 API 请求需要对象的唯一标识符 :id。
这是 Satellite 域的单对象请求格式的示例,ID 为 23:
API 请求
curl \ --request GET \ --user My_User_Name:My_Password \ https://satellite.example.com/api/domains/23 \ | python3 -m json.tool
$ curl \
--request GET \
--user My_User_Name:My_Password \
https://satellite.example.com/api/domains/23 \
| python3 -m json.tool
API 响应
3.2.2. 集合的 JSON 响应格式 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
集合是对象列表,如主机和域。集合 JSON 响应的格式由 metadata 字段和 results 部分组成。
这是 Satellite 域列表集合请求的格式示例:
API 请求
curl \ --request GET \ --user My_User_Name:My_Password \ https://satellite.example.com/api/domains \ | python3 -m json.tool
$ curl \
--request GET \
--user My_User_Name:My_Password \
https://satellite.example.com/api/domains \
| python3 -m json.tool
API 响应
3.2.3. JSON 响应元数据 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
Satellite API 响应包含以下元数据字段:
total- 没有搜索参数的对象总数。
Subtotal- 使用给定搜索参数返回的对象数量。如果没有搜索,则 subtotal 等于 total。
page- 页面号。
per_page- 每个页面返回的最大对象数量。
limit- 要在集合响应中返回的对象数量。
offset- 返回集合前跳过的对象数量。
search-
基于
scoped_scoped语法的搜索字符串。 排序-
通过API 对集合进行排序的字段指定。 -
顺序-排序顺序,可以是升序的 ASC 或 DESC (降序)。
-
results- 对象集合。