Orisumi

按事实时间查询观测

GET
/observations

列出事实时间落在 [from, to) 中的 Observation 的当前版本。匹配只看已知的边界：时段与范围有重叠即返回；只知道一个边界时，按这一刻的时间点匹配；两个边界都未知的 Observation 不返回。结果按已知的开始边界升序分页，开始未知时用结束边界，相同时按 EntityId 升序。

Query Parameters

from*string

范围的开始，包含在内。

Formatdate-time
to*string

范围的结束，不包含在内，必须晚于 from。

Formatdate-time
resourceName?string

观测内容的资源名。只返回观测内容属于这种业务类型的 Observation。

limit?integer

一页最多返回的版本数。

Range1 <= value <= 1000
Default100
after?string

上一页响应中的 next。省略时从第一页开始。

Response Body

一页 Observation 的当前版本。

application/json
  1. response
versions*array<>
next*|

下一页的游标，作为 after 传入。没有下一页时为 null。

Example Request
curl -X GET 'https://example.com/api/observations?from=2019-08-24T14%3A15%3A22Z&to=2019-08-24T14%3A15%3A22Z'
Example Response
{  "versions": [    {      "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5",      "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7",      "previousVersionId": "de7aac6a-ef9d-4693-9e70-ffd12c3baa44",      "category": "observation",      "schemaVersionId": "6856dbc6-454b-45a1-a35b-52f2061b8dca",      "recordedAt": "2019-08-24T14:15:22Z",      "content": {        "observerVersionId": "3a060ba7-4648-481d-8ee6-147a347a183b",        "contentVersionId": "a5a27b60-1951-4448-8e45-5c887f120534",        "inputSetVersionId": "0ffd8fea-521d-4052-adc0-e732666ff823",        "startAt": "2019-08-24T14:15:22Z",        "endAt": "2019-08-24T14:15:22Z",        "timeZone": "string"      }    }  ],  "next": "string"}