From c657851a756f9b077b2d759eef963f1a14a48655 Mon Sep 17 00:00:00 2001 From: James Sandford Date: Fri, 2 Aug 2024 11:52:37 +0100 Subject: [PATCH] Bump API version in readme and examples --- README.md | 12 ++++++------ api/examples/service-get-200.json | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 6da0bc9..770a4ea 100644 --- a/README.md +++ b/README.md @@ -71,17 +71,17 @@ The Flow model is aligned with the principles and schemas of [AMWA NMOS IS-04](h The process of reading from the store is: 1. Client identifies the Flow ID and timerange of interest -2. Client makes a request to [`GET flows//segments?timerange=`](https://bbc.github.io/tams/5.0/index.html#/operations/GET_flows-flowId-segments) and receives a list of Flow Segments, including their timeranges and download URLs +2. Client makes a request to [`GET flows//segments?timerange=`](https://bbc.github.io/tams/5.1/index.html#/operations/GET_flows-flowId-segments) and receives a list of Flow Segments, including their timeranges and download URLs 3. Client downloads each URL, concatenates the Flow Segments together and unwraps the grains within 4. The first and last Flow Segment may contain more grains than requested, so the client should skip any received not in the requested timerange The process of writing to the store is: -1. Client creates a Flow if necessary by making a request to [`PUT flows/`](https://bbc.github.io/tams/5.0/index.html#/operations/PUT_flows-flowId) -2. Client makes a request to [`POST flows//storage`](https://bbc.github.io/tams/5.0/index.html#/operations/POST_flows-flowId-storage) and receives a list of URLs to PUT media data into, along with an optional `pre` URL to call before writing +1. Client creates a Flow if necessary by making a request to [`PUT flows/`](https://bbc.github.io/tams/5.1/index.html#/operations/PUT_flows-flowId) +2. Client makes a request to [`POST flows//storage`](https://bbc.github.io/tams/5.1/index.html#/operations/POST_flows-flowId-storage) and receives a list of URLs to PUT media data into, along with an optional `pre` URL to call before writing 3. If a `pre` URL was given, client calls it 4. Client breaks content into Flow Segments (each of which should contain complete decodable units, _e.g._ a number of complete GOPs for video) and uploads the corresponding media data -5. Client makes requests to [`POST flows//segments`](https://bbc.github.io/tams/5.0/index.html#/operations/POST_flows-flowId-segments) with details of each new Flow Segment created, to register them on the timeline +5. Client makes requests to [`POST flows//segments`](https://bbc.github.io/tams/5.1/index.html#/operations/POST_flows-flowId-segments) with details of each new Flow Segment created, to register them on the timeline ### Sources @@ -110,14 +110,14 @@ Various scenarios are explored in the [Practical Guidance for Media](https://spe ### Flow and Media Timelines Flows exist on an infinite timeline (the "Flow timeline"), and the position of content on this timeline is defined by the `timerange` attribute in each Flow Segment of that Flow. -A timerange is represented in JSON and text using the [TimeRange string pattern](https://bbc.github.io/tams/5.0/index.html#/schemas/timerange). +A timerange is represented in JSON and text using the [TimeRange string pattern](https://bbc.github.io/tams/5.1/index.html#/schemas/timerange). Separately the media objects have a timeline (the "media timeline") defined by the container format itself: the timestamps recorded inside the media object for each grain. The Flow Segment attributes describe how to map the media timeline onto the Flow timeline. For Flows using codecs with temporal re-ordering, both of these timelines represent the presentation timeline of the media. Note that no explicit relationship is defined between the Flow timelines of different Flows, although a mechanism to define that may be added in future. For brevity these diagrams start at `0:0`, however it is likely a practical system would stick closer to wall-clock time or TAI, such as starting at `1709634568:0`. -A timestamp is represented in JSON and text using the [Timestamp string pattern](https://bbc.github.io/tams/5.0/index.html#/schemas/timestamp). +A timestamp is represented in JSON and text using the [Timestamp string pattern](https://bbc.github.io/tams/5.1/index.html#/schemas/timestamp). ![Graphic showing the Flow timeline and 3 Flow Segments in Flow A, with a media timeline showing 10 samples in each object](./docs/images/Flow%20and%20Media%20Timelines-Flow%20A.drawio.png) diff --git a/api/examples/service-get-200.json b/api/examples/service-get-200.json index ce9f897..0c4631f 100644 --- a/api/examples/service-get-200.json +++ b/api/examples/service-get-200.json @@ -10,7 +10,7 @@ "event_stream_mechanisms": [ { "name": "webhooks", - "docs": "https://bbc.github.io/tams/5.0/index.html#/operations/POST_webhooks" + "docs": "https://bbc.github.io/tams/5.1/index.html#/operations/POST_webhooks" } ] }