Profile: audio-card

Profile Schema

An audio-card document is a derivative of the card profile. It specifies a free-form callout content item intended to contain audio.

The audio-card profile is intended to be used as a “type” profile.

Structure

The audio-card profile specifies the following attributes:

Name Type Required? Explanation
emphasisLevel string Yes low, medium, or high
title string No The title to display when rendering this card
attentionLabel string No An extra label displayed alongside the card; common values are BREAKING or EXCLUSIVE
teaser string No A short description of the content represented by the card
isHighPriority boolean No Flag representing whether the card should be visually highlighted for priority
eyebrowText string No String representing a text eyebrow line for a card
eyebrowLink object No Link object representing an external linking eyebrow line for a card. MUST have an href attribute that starts with http or https, and MUST NOT have rels
brandings Link[] No A set of links to organization(s) that should be used to brand this content; see “Brandings” below

Brandings

Similar to the brandings array defined by the publishable profile, the audio-card profile allows its content to be branded using a set of organization links. The brandings array is subject to the following constraints:

  • If present, brandings must contain one or more links
  • Links in brandings must start with http or https
  • Links in brandings cannot have rels

Example audio-card document 

{
  "id": "12345",
  "profiles": [
    {
      "href": "/v1/profiles/audio-card",
      "rels": [
        "type"
      ]
    },
    {
      "href": "/v1/profiles/document"
    }
  ],

  "title": "Listen to the sound of the Marianas trench",
  "emphasisLevel": "medium",
  "attentionLabel": "BREAKING",
  "teaser": "What does the deepest place in the ocean sound like?",
  "eyebrowText": "News",
  "brandings": [
    {
      "href": "https://organization.api.npr.org/v4/services/s1"
    }
  ]
}

© 2024 npr