One story
GET /api/v1/stories/{id}
GET https://terminal.cloud.wavo.me/api/v1/stories/{id}One story by its id, as its page here opens it. A story leaves the wire after 30 days.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | A story's id, from listStories. |
Request
ID=$(curl -s 'https://terminal.cloud.wavo.me/api/v1/stories' | jq -r '.stories[0].id')
curl "https://terminal.cloud.wavo.me/api/v1/stories/$ID"Response
200, application/json: the Story schema in /openapi.json.
| Field | Type | Description |
|---|---|---|
id | string | The story's id: GET /api/v1/stories/{id} opens it. |
headline | string | |
summary | string | The publisher's summary; empty when it gave none. |
topic | object | |
topic.id | one of recorded, rights, live, platforms, capital, policy | |
topic.label | string | |
publisher | object | |
publisher.id | string | |
publisher.name | string | |
author | string or null | |
publishedAt | string | An instant, ISO 8601 in UTC. |
url | string | The article, at its publisher. |
page | string | The story's page on Wavo Intelligence. |
imageUrl | string or null |
Statuses
Every answer carries RateLimit-Policy; a refusal is an RFC 9457 problem, whose codes Errors lists.
| Status | When |
|---|---|
200 | One story. |
404 | No story has this id, or it has left the wire: not_found. |
405 | Any method but GET: method_not_allowed. The API only reads. |
429 | The IP address spent its bucket: rate_limit_exceeded. |
503 | The read behind the answer failed: read_failed. Retry shortly. |