<< Back to Docs Index

GET /daily-reads/:id_or_slug/content v1

GET (Version 1)

Get a single "Daily Read" with most recent post with content

📰 Schema 📰

Headers

Headers Schema

Name Type Description
/^X-(OpenSnow|OpenSummit|OpenMountain)-Token$/i
 string User api token, as returned from user.token in /user/login api response

Route Params

/daily-reads/:id_or_slug/content

Route Params Schema

Name Type Description
id_or_slug
 string A unique id or slug for the Daily Read.
Examples: 3,tahoe,1,colorado

Query String Parameters

Query String Parameters Sample

{
  "v": 1,
  "api_key": "string"
}

Query String Parameters Schema

Name Type Description
v
 integer
Required		 Integer version number == 1
api_key
 string
Required		 API Access Token

Response 200

Response 200 Sample

{
  "daily_read": {
    "id": 0,
    "name": "Colorado",
    "slug": "colorado",
    "timezone": "America/Denver",
    "post": {
      "id": 0,
      "prev_id": 0,
      "next_id": 0,
      "title": "Just Go Skiing Already",
      "summary": "string",
      "author": {
        "id": 0,
        "name": "string",
        "title": "string",
        "photo_url": "http://example.com",
        "bio": "string"
      },
      "post_url": "http://example.com",
      "share_url": "http://example.com",
      "image_url": "http://example.com",
      "is_enabled": true,
      "posted_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "display_at": "2019-08-24T14:15:22Z",
      "display_at_local_label": "Fri 25",
      "display_at_relative": "3 hours ago",
      "post_type": "f",
      "content": "<p>Some HTML content!</p>",
      "content_extended": "<p>Some HTML content!</p>",
      "content_announcements": "<p>Some HTML content!</p>"
    }
  },
  "attribution": {
    "link_url": "http://example.com",
    "link_text": "string",
    "description": "string",
    "image_light_url": "http://example.com",
    "image_dark_url": "http://example.com"
  }
}

Response 200 Schema

Name Type Description
daily_read
 object A "Daily Read" is a Daily Snow, or Daily Summit. Top level meta data, not the individual post.
daily_read.
  id
 integer
Required		 A unique id for the daily read.
daily_read.
  name
 string
Required		 User-friendly name, to be displayed.
Examples: Colorado,Tahoe,Western US
daily_read.
  slug
 string
Required		 Slug (unique), to be used in URLs.
Examples: colorado,tahoe,westernus
daily_read.
  timezone
 string
Required		 IANA timezone name
Examples: America/Denver,America/Los_Angeles
daily_read.
  post
 object
nullable		 A daily read post, an individual blog write up from one of our forecasters.
daily_read.
  post.
    id
 integer
Required		 A unique id for the daily read post.
daily_read.
  post.
    prev_id
 integer
nullable		 A unique id for the previously posted daily read post. Null if this is the oldest post.
daily_read.
  post.
    next_id
 integer
nullable		 A unique id for the next daily read post. Null if this is the newest post.
daily_read.
  post.
    title
 string
Required		 A title for the daily read post.
Examples: Just Go Skiing Already,Deep in the East!
daily_read.
  post.
    summary
 string Short blurb/summary of the post.
daily_read.
  post.
    author
 object
Required		 An author of content articles.
daily_read.
  post.
    author.
      id
 integer
Required		 A unique id for the author.
daily_read.
  post.
    author.
      name
 string
Required		 The name of the author.
daily_read.
  post.
    author.
      title
 string
Required		 The job title of the author.
daily_read.
  post.
    author.
      photo_url
 uri string
Required		 The url to the author's photo.
daily_read.
  post.
    author.
      bio
 string Short biography of the author
daily_read.
  post.
    post_url
 uri string
Required		 The url to an HTML view of the post.
daily_read.
  post.
    share_url
 uri string
Required		 The url to an HTML view of the post, to be shared (and intercepted via deep links).
daily_read.
  post.
    image_url
 uri string URL to summary image for post.
daily_read.
  post.
    is_enabled
 boolean Should this post be visible?
daily_read.
  post.
    posted_at
 date-time string
Required		 The UTC date and time the post was posted.
daily_read.
  post.
    updated_at
 date-time string
Required		 The UTC date and time the post was updated after post.
daily_read.
  post.
    display_at
 date-time string Display time, in UTC (always).
daily_read.
  post.
    display_at_local_label
 string User displayable local timezone date/time label. Opinionated, style varies as appropriate.
Examples: Fri 25,9a,Next 1-5 Days,Yesterday,March 23rd at 9:30am MDT
daily_read.
  post.
    display_at_relative
 string Relative time since display_at timestamp.
Examples: 3 hours ago,1 day ago,2 weeks ago
daily_read.
  post.
    post_type
 string The type of post, where
FULL_POST = 'f'
UPDATE = 'u'
MISC_NEWS = 'm'.
Enum: f,u,m
daily_read.
  post.
    content
 string
nullable		 Daily read post main HTML content.
Example: <p>Some HTML content!</p>
daily_read.
  post.
    content_extended
 string
nullable		 Daily read post extended forecast HTML content.
Example: <p>Some HTML content!</p>
daily_read.
  post.
    content_announcements
 string
nullable		 Daily read post announcements HTML content.
Example: <p>Some HTML content!</p>
attribution
 object Attribution details for data crediting and links back to source content.
attribution.
  link_url
 uri string
nullable		 URL to additional content on OpenSnow or OpenSummit platform.
attribution.
  link_text
 string
nullable		 Text to display for the additional content link.
attribution.
  description
 string
Required		 Fine print disclaimer for attribution of source content.
attribution.
  image_light_url
 uri string
Required		 URL OpenSnow or OpenSummit logo image, for use in light mode themes.
attribution.
  image_dark_url
 uri string
Required		 URL OpenSnow or OpenSummit logo image, for use in dark mode themes.

Response 4xx

Response 4xx Sample

{
  "status_code": 400,
  "error": "Bad Request",
  "messages": [
    "string"
  ]
}

Response 4xx Schema

Name Type Description
status_code
 integer
Required		 HTTP status code
Min: 400   Max: 499
error
 string
Required		 Error description
Examples: Bad Request,Unauthorized,Forbidden,Not Found
messages
 array
Required		 More detailed error message. This may be less-detailed/sanitized in production environments so as not to reveal any potentially sensitive information.
messages[0]
 string

Response 5xx

Response 5xx Sample

{
  "status_code": 500,
  "error": "Internal Server Error",
  "messages": [
    "string"
  ]
}

Response 5xx Schema

Name Type Description
status_code
 integer
Required		 HTTP status code
Min: 500   Max: 599
error
 string
Required		 Error description
Example: Internal Server Error
messages
 array
Required		 More detailed error message. This may be less-detailed/sanitized in production environments so as not to reveal any potentially sensitive information.
messages[0]
 string