{ "swagger": "2.0", "info": { "version": "", "title": "Distribution", "description": "" }, "host": "distribution.int.ngeo.com", "basePath": "/api/v1", "schemes": [ "https" ], "paths": { "/feed/v1/": { "get": { "operationId": "GET_feed-v1", "summary": "Feed", "tags": [ "Endpoints" ], "produces": [ "application/vnd.api+json" ], "parameters": [ { "name": "format", "in": "query", "required": true, "type": "string", "enum": [ "jsonapi" ] }, { "name": "fields", "in": "query", "required": false, "type": "string" }, { "name": "content_type", "in": "query", "required": false, "type": "string" }, { "name": "content_type__not", "in": "query", "required": false, "type": "string" }, { "name": "limit", "in": "query", "required": false, "type": "string" }, { "name": "page", "in": "query", "required": false, "type": "string" }, { "name": "exists_fields", "in": "query", "required": false, "type": "string" }, { "name": "title-abstract", "in": "query", "required": false, "type": "string" }, { "name": "audiences", "in": "query", "required": false, "type": "string" }, { "name": "concepts", "in": "query", "required": false, "type": "string" }, { "name": "events", "in": "query", "required": false, "type": "string" }, { "name": "genres", "in": "query", "required": false, "type": "string" }, { "name": "locations", "in": "query", "required": false, "type": "string" }, { "name": "organizations", "in": "query", "required": false, "type": "string" }, { "name": "persons", "in": "query", "required": false, "type": "string" }, { "name": "series", "in": "query", "required": false, "type": "string" }, { "name": "source", "in": "query", "required": false, "type": "string" }, { "name": "subjects", "in": "query", "required": false, "type": "string" }, { "name": "meta.last_update", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "meta.last_update__from", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "meta.last_update__to", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "publication_datetime", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "publication_datetime__from", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "publication_datetime__to", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "last_modified_datetime", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "last_modified_datetime__from", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "last_modified_datetime__to", "in": "query", "required": false, "type": "string", "format": "date-time" }, { "name": "domain", "in": "query", "required": false, "type": "string" }, { "name": "series.id", "in": "query", "required": false, "type": "string" }, { "name": "id", "in": "query", "required": false, "type": "string" }, { "name": "uri", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "schema": { "$ref": "#/definitions/FeedResponse" } } }, "x-stoplight": { "id": "GET_feed-v1", "beforeScript": null, "afterScript": null, "public": true, "mock": { "statusCode": 200, "dynamic": false, "enabled": false } } } } }, "definitions": { "ComponentGallery": { "title": "ComponentGallery", "description": "Simple gallery. DEPRECATED", "type": "array", "items": { "$ref": "#/definitions/ComponentImage" }, "x-stoplight": { "id": "ComponentGallery", "name": "ComponentGallery", "public": true } }, "BaseArticle": { "title": "BaseArticle", "allOf": [ { "$ref": "#/definitions/BaseItem" }, { "$ref": "#/definitions/TextAsset" }, { "type": "object", "properties": { "uri": { "type": "string", "format": "uri" }, "dek": { "type": [ "string", "null" ], "format": "semantic HTML" }, "canonical_url": { "type": [ "string", "null" ], "format": "uri" }, "vanity_url": { "type": [ "string", "null" ], "format": "uri" }, "short_title": { "type": "string" }, "galleries": { "type": "array" }, "body": { "type": "string", "format": "HTML" }, "videos": { "type": "array", "items": { "$ref": "#/definitions/ComponentVideo" } }, "lead_media": { "oneOf": [ { "properties": { "image": { "$ref": "#/definitions/ComponentImage" } }, "required": [ "image" ] }, { "properties": { "video": { "$ref": "#/definitions/ComponentVideo" } }, "required": [ "video" ] }, { "properties": { "image_gallery": { "$ref": "#/definitions/ComponentImageGallery" } }, "required": [ "image_gallery" ] } ], "type": "object" }, "images": { "type": "array", "items": { "$ref": "#/definitions/ComponentImage" } }, "contributors": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/Contributor" }, { "type": "object", "properties": { "order": { "type": "integer" } } } ] } }, "content_type": { "type": "string", "enum": [ "article:story", "article:image_gallery", "article:reference" ] } }, "required": [ "uri" ] } ], "x-stoplight": { "id": "BaseArticle", "name": "BaseArticle", "public": true } }, "FeaturedText": { "title": "FeaturedText", "allOf": [ { "$ref": "#/definitions/BaseItem" }, { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" } }, "pull_quote": { "$ref": "#/definitions/ComponentPullQuote" }, "image": { "$ref": "#/definitions/ComponentImage" }, "content_type": { "type": "string", "enum": [ "featured_text" ] } }, "required": [ "uri" ] } ], "x-stoplight": { "id": "FeaturedText", "name": "FeaturedText", "public": true } }, "ClassifiedObject": { "title": "ClassifiedObject", "type": "object", "description": "The object has taxonomy tags applied", "properties": { "audiences": { "$ref": "#/definitions/TaxonomyTopic" }, "concepts": { "$ref": "#/definitions/TaxonomyTopic" }, "events": { "$ref": "#/definitions/TaxonomyTopic" }, "genres": { "$ref": "#/definitions/TaxonomyTopic" }, "locations": { "$ref": "#/definitions/TaxonomyTopic" }, "organizations": { "$ref": "#/definitions/TaxonomyTopic" }, "persons": { "$ref": "#/definitions/TaxonomyTopic" }, "series": { "$ref": "#/definitions/TaxonomyTopic" }, "sources": { "$ref": "#/definitions/TaxonomyTopic" }, "subjects": { "$ref": "#/definitions/TaxonomyTopic" } }, "x-stoplight": { "id": "ClassifiedObject", "name": "ClassifiedObject", "public": true } }, "BaseItem": { "title": "BaseItem", "type": "object", "description": "Common set of properties", "properties": { "id": { "type": "string" }, "language": { "type": "string", "description": "Language and locale in the format: xx-YY, examples: en-US, es-AR, en-AU" }, "publication_datetime": { "type": "string", "format": "date-time" }, "last_modified_datetime": { "type": "string", "format": "date-time" }, "parent": { "type": "string" }, "localizations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "language": { "type": "string" } } } } }, "required": [ "id", "publication_datetime", "last_modified_datetime" ], "x-stoplight": { "id": "BaseItem", "name": "BaseItem", "public": true } }, "ComponentImmersiveLead": { "title": "ComponentImmersiveLead", "type": "object", "properties": { "lead_media": { "type": "object", "properties": { "content_type": { "type": "string", "enum": [ "video", "image" ] }, "content": { "oneOf": [ { "$ref": "#/definitions/ComponentVideo" }, { "$ref": "#/definitions/ComponentImage" } ] } } }, "title": { "type": "string" }, "caption": { "type": "string" }, "tint": { "type": "string", "enum": [ "NONE", "LIGHT", "MEDIUM", "DARK" ], "default": "NONE" }, "focal_point": { "type": [ "object", "null" ], "properties": { "x": { "type": "string", "default": "", "enum": [ "LEFT", "MIDDLE", "RIGHT" ] }, "y": { "type": "string", "enum": [ "TOP", "MIDDLE", "BOTTOM" ] } }, "required": [ "x", "y" ] }, "text_position": { "type": [ "object", "null" ], "properties": { "x": { "type": "string", "enum": [ "LEFT", "MIDDLE", "RIGHT" ], "default": "LEFT" }, "y": { "type": "string", "enum": [ "TOP", "MIDDLE", "BOTTOM" ], "default": "BOTTOM" } }, "required": [ "x", "y" ] }, "theme": { "type": "string", "enum": [ "NEGATIVE", "POSITIVE" ] }, "show_arrow_down": { "type": "boolean", "default": true }, "kicker": { "type": "string" } }, "required": [ "lead_media", "tint", "theme" ], "example": { "lead_media": { "content_type": "image", "image": { "description": null, "duration": 52415058, "mime_type": null, "source_system": null, "thumbnail": null, "title": "velit quis Duis eius", "uri": "id magna cillum et" } }, "title": "officia", "caption": "Ut officia nostrud ut id", "tint": "NONE", "focal_point": { "x": "RIGHT", "y": "BOTTOM" }, "text_position": null, "theme": "POSITIVE", "show_arrow_down": true, "kicker": "labore in cillum nostrud ullamco" }, "x-stoplight": { "id": "ComponentImmersiveLead", "name": "ComponentImmersiveLead", "public": true } }, "Article": { "title": "Article", "allOf": [ { "$ref": "#/definitions/BaseArticle" }, { "type": "object", "properties": { "alt_bodies": { "$ref": "#/definitions/AltBodies" } } } ], "example": { "abstract": "Towering flares and daytime planets are among the unique sky shows in store for people in the path of totality.", "alt_bodies": { "structured": { "content": [ { "content_type": "image_gallery", "image_gallery": { "aspect_ratio_type": "three-two", "gallery_size": "S", "images": [ { "alt_text": "Picture of total solar eclipse", "aspect_ratio": 0.66650390625, "asset_provider": { "asset_id": "GettyImages-519060130", "id": "ngs_rights_vendor:Getty", "uri": null }, "asset_source": null, "caption": "This picture of the diamond ring effect was taken during an eclipse seen from Miahuatlán, Mexico, in 1970.", "credit": "Photograph by Roger Ressmeyer, Corbis, VCG via Getty", "croppings": [], "height": 1365, "id": "886aa714-7526-4ef6-965b-c9731f446871", "renditions": [ { "density": "1", "media-selector": "(max-width: 130px)", "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/2-solar-eclipse-GettyImages-519060130.adapt.133.1.jpg", "width": "133" } ], "rights_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "886aa714-7526-4ef6-965b-c9731f446871", "id": "aem-us" }, "source_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "886aa714-7526-4ef6-965b-c9731f446871", "id": "aem-us" }, "title": null, "type": "inline", "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/2-solar-eclipse-GettyImages-519060130.jpg", "width": 2048 } ], "show_image_asset_sources": true, "show_image_captions": true, "show_image_credits": true, "show_image_titles": false, "title": null } }, { "content_type": "gallery", "gallery": [ { "alt_text": "Picture of total solar eclipse", "aspect_ratio": 0.66650390625, "asset_provider": { "asset_id": "GettyImages-519060130", "id": "ngs_rights_vendor:Getty", "uri": null }, "asset_source": null, "caption": "This picture of the diamond ring effect was taken during an eclipse seen from Miahuatlán, Mexico, in 1970.", "credit": "Photograph by Roger Ressmeyer, Corbis, VCG via Getty", "croppings": [], "height": 1365, "id": "886aa714-7526-4ef6-965b-c9731f446871", "order": 0, "renditions": [ { "density": "1", "media-selector": "(max-width: 130px)", "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/2-solar-eclipse-GettyImages-519060130.adapt.133.1.jpg", "width": "133" } ], "rights_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "886aa714-7526-4ef6-965b-c9731f446871", "id": "aem-us" }, "source_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "886aa714-7526-4ef6-965b-c9731f446871", "id": "aem-us" }, "title": null, "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/2-solar-eclipse-GettyImages-519060130.jpg", "width": 2048 } ] }, { "content_type": "text", "text": "

As the moon glides in front of the sun..." }, { "content_type": "video", "video": { "description": "A total solar eclipse...", "duration": 282749, "mime_type": "video/mp4", "source_system": { "account": "2423130747", "asset_external_field_name": "id", "asset_id": "1005835843746", "id": "mpx-us" }, "thumbnail": "http://pmdvod.nationalgeographic.com/NG_Video/776/831/smpost_1500670706938.jpg", "title": "Solar Eclipse 101", "type": "Universal Video", "uri": "http://link.theplatform.com/s/ngs/media/guid/2423130747/0000015d-66df-d466-a57f-fedf98110000" } }, { "content_type": "image", "image": { "alt_text": "Sequence of photos of the sun during a total solar eclipse.", "aspect_ratio": 0.787109375, "asset_provider": { "asset_id": "NationalGeographic_1979648.", "id": "ngs_rights_vendor:SPI", "uri": null }, "asset_source": null, "caption": "A composite picture taken from a cruise ship near Iwo Jima captures a 2009 eclipse in the moments before, during, and after totality.", "credit": "Photograph by Corbis via Getty Images", "cropped": false, "croppings": [], "height": 1612, "id": "feb2bbe3-ea96-4162-9872-f9721ea05c2f", "renditions": [ { "density": "1", "media-selector": "(max-width: 130px)", "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/4-solar-eclipse-NationalGeographic_1979648.adapt.133.1.jpg", "width": "133" } ], "size": "small", "source_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "feb2bbe3-ea96-4162-9872-f9721ea05c2f", "id": "aem-us" }, "title": null, "type": "inline", "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/4-solar-eclipse-NationalGeographic_1979648.jpg", "width": 2048 } } ] }, "text": { "body": "As the moon glides in front" } }, "body": "

As the moon glides in front of the", "content_type": "article:story", "contributors": [ { "name": "Andrew Fazekas", "order": 0, "role": "writer", "role_other": null, "taxonomy_id": "fa755075-1818-3568-ba30-75534ba2b4b1", "uri": null } ], "id": "News:9e39855f-d30c-469c-aff8-7c85db9ab3f4", "images": [ { "alt_text": "Picture of total solar eclipse", "aspect_ratio": 0.66650390625, "asset_provider": { "asset_id": "GettyImages-519060130", "id": "ngs_rights_vendor:Getty", "uri": null }, "asset_source": null, "caption": "A total solar eclipse with the disk of the sun showing along one edge of the moon, giving a "diamond ring" effect. | Location: Miahuatlan, Mexico.", "credit": "Photograph by Roger Ressmeyer, Corbis, VCG via Getty", "croppings": [], "height": 1365, "id": "886aa714-7526-4ef6-965b-c9731f446871", "order": 0, "renditions": [ { "density": "1", "media-selector": "(max-width: 130px)", "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/2-solar-eclipse-GettyImages-519060130.adapt.133.1.jpg", "width": "133" } ], "source_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "886aa714-7526-4ef6-965b-c9731f446871", "id": "aem-us" }, "title": "2-solar-eclipse-phenomenon", "type": "OG", "uri": "http://news.nationalgeographic.com/content/dam/news/2017/08/10/solar_eclipse_phenomena/2-solar-eclipse-GettyImages-519060130.jpg", "width": 2048 } ], "keywords": [ "space", "solar eclipses", "amateur astronomy" ], "language": "en-US", "last_modified_datetime": "2017-08-17T19:58:00.000000Z", "localizations": [], "publication_datetime": "2017-08-17T19:58:00.000000Z", "title": "Amazing Sights You Can Only See During a Solar Eclipse", "uri": "http://news.nationalgeographic.com/2017/08/watch-total-solar-eclipse-sun-sights-space-science/", "videos": [ { "audio_channels": null, "audio_sample_rate": null, "bitrate": null, "default": false, "description": "A total solar eclipse happens somewhere on Earth once every year or two. What is an eclipse? Learn more about how solar eclipses happen, the four types of eclipses, and how to view the sun safely if you're within the path of totality.\n\nEclipse map adapted with permission: https://www.exploratorium.edu/eclipse", "duration": 282749, "expression": null, "file_size": null, "format": null, "frame_rate": null, "height": null, "language": null, "mime_type": "video/mp4", "order": 0, "source_system": { "account": "2423130747", "asset_external_field_name": "id", "asset_id": "1005835843746", "id": "mpx-us" }, "thumbnail": "http://pmdvod.nationalgeographic.com/NG_Video/776/831/smpost_1500670706938.jpg", "title": "Solar Eclipse 101", "type": "Universal Video", "uri": "http://link.theplatform.com/s/ngs/media/guid/2423130747/0000015d-66df-d466-a57f-fedf98110000", "width": null } ] }, "x-stoplight": { "id": "Article", "name": "Article", "public": true } }, "ComponentListicle": { "title": "ComponentListicle", "type": "object", "properties": { "title": { "type": "string" }, "dek": { "type": "string" }, "text": { "type": "string" }, "display_order": { "type": "number" }, "image": { "$ref": "#/definitions/ComponentImage" } }, "required": [ "title" ], "example": { "title": "EPA DISMISSES SCIENCE ADVISORS", "dek": "May 5, 2017", "text": "The EPA dismisses several members of the Board of Scientific Counselors, an 18-member advisory board that reviews the research of EPA scientists. Some of the dismissed scientists had been assured that their three-year terms on the board would be renewed. In a May 7 story by the New York Times, critics assailed the move...", "display_order": -1 }, "x-stoplight": { "id": "ComponentListicle", "name": "ComponentListicle", "public": true } }, "ComponentInlinePromo": { "title": "ComponentInlinePromo", "type": "object", "properties": { "text": { "type": "string" }, "is_optional": { "type": "boolean", "default": false }, "heading": { "type": "string" } }, "required": [ "text", "is_optional" ], "x-stoplight": { "id": "ComponentInlinePromo", "name": "ComponentInlinePromo", "public": true } }, "SourceSystem": { "title": "SourceSystem", "type": "object", "properties": { "id": { "type": "string", "enum": [ "mpx-us", "neulion-au", "yourshot-us", "aem-us", "chook-au", "spi-us", "Getty", "yourshot" ] }, "asset_id": { "type": "string" }, "account": { "type": [ "string", "null" ] }, "asset_external_field_name": { "type": [ "string", "null" ] } }, "required": [ "id", "asset_id" ], "x-stoplight": { "id": "SourceSystem", "name": "SourceSystem", "public": true } }, "BaseMagazineIssue": { "title": "BaseMagazineIssue", "allOf": [ { "$ref": "#/definitions/BaseItem" }, { "type": "object", "properties": { "content_type": { "type": "string", "enum": [ "magazine:issue" ] }, "year": { "type": "string" }, "issue_number": { "type": "string" }, "issue_label": { "type": "string" }, "magazine_id": { "type": "string" }, "cover_image": { "$ref": "#/definitions/ComponentImage" } }, "required": [ "year", "issue_number", "issue_label", "cover_image" ] } ], "x-stoplight": { "id": "BaseMagazineIssue", "name": "BaseMagazineIssue", "public": true } }, "ComponentPullQuote": { "title": "ComponentPullQuote", "type": "object", "properties": { "name": { "type": "string" }, "quote": { "type": "string" }, "quote_details": { "type": [ "string", "null" ] }, "person_taxonomy_tag": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "order": { "type": "integer" }, "uuid": { "type": "string" } }, "required": [ "name", "uuid" ] } }, "required": [ "name", "quote" ], "x-stoplight": { "id": "ComponentPullQuote", "name": "ComponentPullQuote", "public": true } }, "Renditions": { "title": "Renditions", "id": "resource:/definitions/Renditions#", "type": "array", "items": { "type": "object", "properties": { "width": { "type": "string" }, "uri": { "type": "string", "format": "uri" }, "density": { "type": [ "string", "null" ] }, "media-selector": { "type": "string" } }, "required": [ "width", "uri" ] }, "x-stoplight": { "id": "Renditions", "name": "Renditions", "public": true } }, "ComponentAnimalFact": { "title": "ComponentAnimalFact", "type": "object", "properties": { "size_comparison_label": { "type": "string" }, "animal_subject": { "description": "Taxonomy UUID", "type": "string" }, "captivity_lifespan_low": { "type": "number" }, "captivity_lifespan_median": { "type": "number" }, "captivity_lifespan_high": { "type": "number" }, "wild_lifespan_low": { "type": "number" }, "wild_lifespan_median": { "type": "number" }, "wild_lifespan_high": { "type": "number" }, "lifespan_notes": { "type": "string" }, "name": { "type": "string" }, "scientific_name": { "type": "array", "items": { "type": "string" } }, "diet_details": { "type": "string" }, "animal_type": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "name": { "type": "string" } }, "required": [ "url", "name" ] }, "size": { "type": "string" }, "weight": { "type": "string" }, "population_trend": { "type": "string" }, "relative_size_image": { "$ref": "#/definitions/ComponentImage" }, "animal_reference_image": { "$ref": "#/definitions/ComponentImage" } }, "required": [ "animal_subject", "name" ], "x-stoplight": { "id": "ComponentAnimalFact", "name": "ComponentAnimalFact", "public": true } }, "ComponentImageGroup": { "title": "ComponentImageGroup", "description": "Group of two images", "type": "object", "properties": { "caption": { "type": [ "string", "null" ] }, "size": { "type": [ "string", "null" ], "enum": [ "XS", "S", "M", "L", "FULL" ] }, "images": { "type": "array", "items": { "$ref": "#/definitions/ComponentImage" } }, "hide_gutter": { "type": "boolean", "default": false }, "exclude_from_media_set": { "type": "boolean", "default": false }, "is_optional": { "type": "boolean", "default": false }, "title": { "type": [ "string", "null" ] } }, "required": [ "images" ], "x-stoplight": { "id": "ComponentImageGroup", "name": "ComponentImageGroup", "public": true } }, "ComponentImageGallery": { "title": "ComponentImageGallery", "description": "Replace the Gallery component.", "type": "object", "properties": { "aspect_ratio_type": { "type": [ "string", "null" ] }, "gallery_size": { "type": [ "string", "null" ], "enum": [ "XS", "S", "M", "L", "FULL" ] }, "images": { "type": "array", "items": { "$ref": "#/definitions/ComponentImage" } }, "show_image_asset_sources": { "type": "boolean" }, "show_image_titles": { "type": "boolean" }, "show_image_captions": { "type": "boolean" }, "show_image_credits": { "type": "boolean" }, "title": { "type": [ "string", "null" ] } }, "required": [ "images" ], "x-stoplight": { "id": "ComponentImageGallery", "name": "ComponentImageGallery", "public": true } }, "TaxonomyRelationshipTopic": { "title": "TaxonomyRelationshipTopic", "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" } }, "x-stoplight": { "id": "TaxonomyRelationshipTopic", "name": "TaxonomyRelationshipTopic", "public": true } }, "ComponentExcerpt": { "title": "ComponentExcerpt", "type": "object", "properties": { "excerpt": { "type": "string" } }, "x-stoplight": { "id": "ComponentExcerpt", "name": "ComponentExcerpt", "public": true } }, "TextAsset": { "title": "TextAsset", "type": "object", "properties": { "title": { "type": "string" }, "seo_title": { "type": [ "string", "null" ] }, "social_title": { "type": [ "string", "null" ] }, "abstract": { "type": [ "string", "null" ] }, "short_abstract": { "type": [ "string", "null" ] }, "sponsor_content": { "type": "boolean", "default": false }, "sponsor_content_label": { "type": [ "string", "null" ] }, "keywords": { "type": "array", "items": { "type": "string" } } }, "required": [ "title" ], "x-stoplight": { "id": "TextAsset", "name": "TextAsset", "public": true } }, "ComponentYoutubeVideo": { "title": "ComponentYoutubeVideo", "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "credit": { "type": "string" }, "embed_url": { "type": "string", "format": "uri" }, "size": { "type": "string", "enum": [ "XS", "S", "M", "L", "FULL" ] }, "aspect_ratio": { "type": "string", "enum": [ "2:1", "3:4", "3:2", "4:3", "9:16", "16:9" ] } }, "required": [ "embed_url", "size", "aspect_ratio" ], "example": { "title": "42", "description": "

NASA's eclipse live coverage will begin at 12 p.m. ET on August 21.

\n", "credit": "This is a credit", "embed_url": "https://www.youtube.com/embed/wwMDvPCGeE0", "size": "S", "aspect_ratio": "16:9" }, "x-stoplight": { "id": "ComponentYoutubeVideo", "name": "ComponentYoutubeVideo", "public": true } }, "AltBodies": { "title": "AltBodies", "type": "object", "properties": { "structured": { "type": "object", "required": [ "content" ], "properties": { "content": { "type": "array", "items": { "oneOf": [ { "properties": { "content_type": { "type": "string", "enum": [ "image" ] }, "image": { "$ref": "#/definitions/ComponentImage" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "text" ] }, "text": { "type": "string" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "video" ] }, "video": { "$ref": "#/definitions/ComponentVideo" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "pull_quote" ] }, "pull_quote": { "$ref": "#/definitions/ComponentPullQuote" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "excerpt" ] }, "excerpt": { "$ref": "#/definitions/ComponentExcerpt" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "animal_facts" ] }, "animal_facts": { "$ref": "#/definitions/ComponentAnimalFact" } } }, { "description": "Deprecated. Use ImageGallery instead", "properties": { "content_type": { "type": "string", "enum": [ "gallery" ] }, "gallery": { "$ref": "#/definitions/ComponentGallery" } } }, { "description": "Replace Gallery component", "properties": { "content_type": { "type": "string", "enum": [ "image_gallery" ] }, "image_gallery": { "$ref": "#/definitions/ComponentImageGallery" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "inline_promo" ] }, "inline_promo": { "$ref": "#/definitions/ComponentInlinePromo" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "listicle" ] }, "listicle": { "$ref": "#/definitions/ComponentListicle" } } }, { "properties": { "content_type": { "type": "string", "enum": [ "immersive_lead" ] }, "immersive_lead": { "$ref": "#/definitions/ComponentImmersiveLead" } } } ], "type": "object" } } } }, "text": { "type": "object", "required": [ "body" ], "properties": { "body": { "type": "string" } } } }, "required": [ "structured", "text" ], "x-stoplight": { "id": "AltBodies", "name": "AltBodies", "public": true } }, "FeaturedImage": { "title": "FeaturedImage", "allOf": [ { "$ref": "#/definitions/BaseItem" }, { "$ref": "#/definitions/TextAsset" }, { "type": "object", "properties": { "collection_id": { "type": "string" }, "uri": { "type": "string", "format": "uri" }, "canonical_url": { "type": [ "string", "null" ] }, "vanity_url": { "type": [ "string", "null" ] }, "dek": { "type": [ "string", "null" ], "format": "semantic HTML" }, "image": { "$ref": "#/definitions/ComponentImage" }, "contributors": { "type": "array", "items": { "allOf": [ { "$ref": "#/definitions/Contributor" }, { "type": "object", "properties": { "order": { "type": "integer" } } } ] } }, "content_type": { "type": "string", "enum": [ "featured_image" ] } }, "required": [ "collection_id", "uri" ] } ], "example": { "id": "Photography:907a80ba-e834-42b9-9720-bbeb40ebb15b", "language": "en-US", "publication_datetime": "2017-08-18T04:00:00.000000Z", "last_modified_datetime": "2017-08-18T04:00:00.000000Z", "abstract": null, "collection_id": "fd5444cc-4777-4438-b9d4-5085c0564b44", "content_type": "featured_image", "contributors": [], "dek": "

Air Force Academy graduates celebrate in this National Geographic Your Shot Photo of the Day.

", "image": { "alt_text": "Picture of Air Force cadets throwing caps into the air to celebrate graduation", "aspect_ratio": 0.6183553916250814, "asset_provider": null, "caption": "

Graduates of the United States Air Force Academy", "credit": "AJ Lee", "croppings": [], "height": 2850, "order": 0, "renditions": [ { "density": null, "uri": "http://yourshot.nationalgeographic.com/u/fQYSUbVfts-T7odkrFJckdiFeHvab0GWOfzhj7tYdC0uglagsDNeYPB62q8/", "width": "240" } ], "source_system": { "account": null, "asset_external_field_name": null, "asset_id": "10440473", "id": "yourshot", "uri": "http://yourshot.nationalgeographic.com/photos/10440473/" }, "title": "Graduation Celebration", "uri": "http://yourshot.nationalgeographic.com/u/fQYSUbVfts-T7odkrFJckdiFeHvab0GWOfzhj7tYdC0uglagsDNeYPB62q8/", "width": 4609 }, "keywords": [ "natgeoyourshot" ], "seo_title": "Air Force Graduation Image National Geographic Your Shot Photo of the Day", "short_abstract": "Air Force Academy graduates celebrate in this National Geographic Your Shot Photo of the Day.", "short_title": "Graduation Celebration", "social_title": "Air Force Graduation Image", "sponsor_content": false, "sponsor_content_label": null, "title": "Graduation Celebration", "uri": "http://www.nationalgeographic.com/photography/photo-of-the-day/2017/08/cadets-air-force-colorado/" }, "x-stoplight": { "id": "FeaturedImage", "name": "FeaturedImage", "public": true } }, "Contributor": { "title": "Contributor", "type": "object", "properties": { "name": { "type": "string" }, "taxonomy_id": { "type": [ "string", "null" ] }, "uri": { "type": [ "string", "null" ], "format": "uri" }, "role": { "type": "string", "enum": [ "writer", "photographer", "other" ] }, "role_other": { "type": [ "string", "null" ] } }, "required": [ "name", "role" ], "x-stoplight": { "id": "Contributor", "name": "Contributor", "public": true } }, "StoryRelationshipTopic": { "title": "StoryRelationshipTopic", "type": "array", "items": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "meta": { "type": "object", "properties": { "title": { "type": "string" }, "lead_media": { "type": "object", "properties": { "content_type": { "type": "string", "enum": [ "image", "video", "image_gallery", "group_image" ] }, "image": { "$ref": "#/definitions/ComponentImage" } } }, "genre": { "type": "object", "properties": { "uuid": { "type": "string" }, "name": { "type": "string" } } }, "series": { "type": "object", "properties": { "uuid": { "type": "string" }, "name": { "type": "string" } } } } } } }, "links": { "type": "object", "properties": { "related": { "type": "string", "format": "uri" }, "href": { "type": "string", "format": "uri" } } } } }, "x-stoplight": { "id": "StoryRelationshipTopic", "name": "StoryRelationshipTopic", "public": true } }, "FeedResponse": { "title": "FeedResponse", "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "links": { "type": "object", "properties": { "self": { "type": "string", "format": "uri" } } }, "type": { "type": "string", "enum": [ "article:story", "article:image_gallery", "article:reference", "featured_image", "featured_text", "magazine_issue" ] }, "attributes": { "anyOf": [ { "$ref": "#/definitions/Article" }, { "$ref": "#/definitions/FeaturedImage" }, { "$ref": "#/definitions/FeaturedText" }, { "$ref": "#/definitions/MagazineIssue" }, { "$ref": "#/definitions/CollectionFeaturedImage" }, { "$ref": "#/definitions/Magazine" } ] }, "relationships": { "type": "object", "properties": { "audiences": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "concepts": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "events": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "genres": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "locations": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "organizations": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "persons": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "series": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "sources": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "subjects": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/definitions/TaxonomyRelationshipTopic" } } }, "required": [ "data" ] }, "story": { "$ref": "#/definitions/StoryRelationshipTopic" } } } }, "required": [ "id", "links", "type", "attributes", "relationships" ] } }, "included": { "type": "array", "items": { "type": "object", "properties": { "attributes": { "type": "object", "required": [ "name", "topic_type" ], "properties": { "name": { "type": "string" }, "topic_type": { "type": "string" } } }, "id": { "type": "string" }, "links": { "type": "object", "required": [ "self" ], "properties": { "self": { "type": "string", "format": "uri" } } }, "type": { "type": "string" } }, "required": [ "attributes", "id", "links", "type" ] } }, "meta": { "type": "object", "required": [ "pages", "feeds" ], "properties": { "pages": { "type": "integer" }, "feeds": { "type": "integer" } } }, "links": { "type": "object", "properties": { "first": { "type": "string", "format": "uri" }, "last": { "type": "string", "format": "uri" }, "next": { "type": [ "string", "null" ], "format": "uri" }, "self": { "type": "string", "format": "uri" } } }, "jsonapi": { "type": "object", "required": [ "version" ], "properties": { "version": { "type": "string" } } } }, "required": [ "data", "meta", "links", "jsonapi" ], "example": { "data": [ { "attributes": { "id": "123456", "uri": "http://nationalgeographic.com/foo", "abstract": "The U.S. government may want to withdraw from the Paris Agreement, but these states and cities are still committed to climate progress.", "contributors": [ { "name": "Michael Greshko", "order": 0, "role": "writer", "role_other": null, "taxonomy_id": "6101784e-7f26-3d44-a780-6e8fa9307f3d", "uri": "http://www.nationalgeographic.com/contributors/g/michael-greshko" } ], "dek": "

The U.S. government may want to withdraw from the Paris Agreement, but these states and cities are still committed to climate progress.

", "keywords": [ "climate change", "renewable energy" ], "language": "en-US", "last_modified_datetime": "2017-06-08T20:24:57.000000Z", "lead_media": { "content_type": "image", "image": { "alt_text": null, "aspect_ratio": 0.6506024096385542, "asset_provider": {}, "asset_source": null, "caption": null, "credit": null, "croppings": [], "height": 972, "id": "6a17a0d8-3f3f-49c6-a8a4-370fec6b8125", "renditions": [ { "density": "1", "media-selector": "(max-width: 1900px)", "uri": "http://news.nationalgeographic.com/content/dam/news/rights-exempt/nat-geo-staff-graphics-illustrations/2017/06/ClimateStatesCities_OG.adapt.1900.1.png", "width": "1900" } ], "rights_system": null, "source_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "6a17a0d8-3f3f-49c6-a8a4-370fec6b8125", "id": "aem-us" }, "title": null, "type": "OG", "uri": "http://news.nationalgeographic.com/content/dam/news/rights-exempt/nat-geo-staff-graphics-illustrations/2017/06/ClimateStatesCities_OG.png", "width": 1494 } }, "localizations": [], "meta": { "created_at": "2017-06-08T20:24:57.998846Z", "domain": "News", "is_deleted": false, "last_update": "2017-06-08T20:24:57.998846Z" }, "publication_datetime": "2017-06-08T19:42:46.000000Z", "seo_title": "Map Shows Growing U.S. 'Climate Rebellion' Against Trump", "short_abstract": "The U.S. government may want to withdraw from the Paris Agreement, but these states and cities are still committed to climate progress.", "short_title": "Map Shows Growing U.S. 'Climate Rebellion' Against Trump", "social_title": "Map Shows Growing U.S. 'Climate Rebellion' Against Trump", "sponsor_content": false, "title": "Map Shows Growing U.S. 'Climate Rebellion' Against Trump", "alt_bodies": { "structured": { "content": [ { "content_type": "text", "text": "

As the aftershocks of the Trump administration’s June 1 rejection of the Paris Agreement continue to rumble, groups across the United States have rebelled against the decision to withdraw from the the international climate pact.

" }, { "content_type": "video", "video": { "description": "Climate Change is a real and serious issue. In this video Bill Nye, the Science Guy, explains what causes climate change, how it affects our planet, why we need to act promptly to mitigate its effects, and how each of us can contribute to a solution.", "duration": 249549, "mime_type": "video/mp4", "source_system": { "account": "2423130747", "asset_external_field_name": "id", "asset_id": "576651331546", "id": "mpx-us" }, "thumbnail": "http://pmdvod.nationalgeographic.com/NG_Video/50/578/cc-nye-1_640x360_892138051969.jpg", "title": "Climate Change 101 with Bill Nye", "type": "Universal Video", "uri": "http://link.theplatform.com/s/ngs/media/guid/2423130747/00000151-5aa6-d836-a9f3-fee639890000" } }, { "content_type": "text", "text": "

Among the three countries, the U.S. would stand alone in withdrawing from the accord. The other two countries never joined: Nicaragua didn’t feel as though the Paris Agreement was ambitious enough, and a vicious civil war and international sanctions left Syria unable to attend the negotiations.

" } ] }, "text": { "body": "As the aftershocks of the Trump administration’s June 1 rejection of the Paris Agreement continue to rumble, groups across the United States have rebelled against the decision to withdraw from the the international climate pact.\n\nStates, cities, businesses, philanthropies, and universities have vowed to fill the void that the U.S. federal government makes if it departs from the accord or ignores its voluntary targets: a 26 to 28-percent reduction in the country’s carbon emissions by 2025, relative to 2005 levels, and further cuts thereafter.\n\nAlready, billionaire philanthropist and former New York City mayor Michael Bloomberg has pledged to donate $15 million to the U.N. Framework Convention on Climate Change, in order to help fill any funding gaps created by the Trump administration’s departure.\n\nThe same day as Trump’s announcement, the states of New York, California, and Washington announced the formation of the United States Climate Alliance. The coalition aims to uphold U.S. commitments under the Paris Agreement, and it also says it wants to meet or exceed the Clean Power Plan, an Obama-era EPA rule on power plant emissions.\n\nAs of June 7, the U.S. Climate Alliance has amassed 12 states and Puerto Rico, collectively representing more than a hundred million Americans and a third of the U.S. GDP. One member state, Hawaii, passed a law on June 6 formally committing the state to the Paris Agreement. Jerry Brown, the governor of member state California, has positioned himself as the U.S.’s de facto climate leader, attending meetings on climate change with leading Chinese officials at a recent clean-energy conference.\n\nSeparately, U.S. states, state attorneys general, cities, businesses, and universities have banded together into a coalition called We Are Still In. The group, spearheaded by Bloomberg, has signatories from 125 cities, nine states, 183 colleges and universities, and 902 businesses. The group says that it represents 120 million Americans and $6.2 trillion in contributions to the U.S. economy.\n\nIn addition, 274 U.S. mayors representing 58 million Americans have signed onto a statement prepared by the Mayors National Climate Action Agenda (MNCAA) network to uphold the Paris Agreement, as of the evening of June 7, 2017.\n\nIf the U.S. follows through with its pledge to formally withdraw from the pact, which cannot happen formally until November 4, 2020, the country would join just two others—Syria and Nicaragua—as non-parties to the agreement. (Find out how withdrawing from Paris could isolate the U.S. from the world.)\n\nAmong the three countries, the U.S. would stand alone in withdrawing from the accord. The other two countries never joined: Nicaragua didn’t feel as though the Paris Agreement was ambitious enough, and a vicious civil war and international sanctions left Syria unable to attend the negotiations." } } }, "id": "News:8749e429-e987-404c-8bc7-ecbe11369e8f", "links": { "self": "https://relay.nationalgeographic.com/proxy/distribution/api/v1/item/News:8749e429-e987-404c-8bc7-ecbe11369e8f/?format=jsonapi" }, "relationships": { "series": { "data": [] }, "subjects": { "data": [ { "id": "8991760a-3b95-3df0-a993-3b66f2f247ed", "type": "taxonomy_topic" }, { "id": "244f3686-f82f-3441-9b26-c1019e893c26", "type": "taxonomy_topic" }, { "id": "e69f1e8c-c995-31cf-a3b7-cdab6f515475", "type": "taxonomy_topic" } ] } }, "type": "article:story" } ], "meta": { "pages": 72, "feeds": 72 }, "links": { "first": "https://relay.nationalgeographic.com/proxy/distribution/feed/v1/?fields=abstract%2Ccontributors%2Cdek%2Ckeywords%2Clanguage%2Clast_modified_datetime%2Clead_media%2Clocalizations%2Cmeta%2Cpublication_datetime%2Cseo_title%2Cseries%2Cshort_abstract%2Cshort_title%2Csocial_title%2Csponsor_content%2Ctitle&limit=1&page=1&content_type=article%3Astory&format=jsonapi", "last": "https://relay.nationalgeographic.com/proxy/distribution/feed/v1/?fields=abstract%2Ccontributors%2Cdek%2Ckeywords%2Clanguage%2Clast_modified_datetime%2Clead_media%2Clocalizations%2Cmeta%2Cpublication_datetime%2Cseo_title%2Cseries%2Cshort_abstract%2Cshort_title%2Csocial_title%2Csponsor_content%2Ctitle&limit=1&page=72&content_type=article%3Astory&format=jsonapi", "next": "https://relay.nationalgeographic.com/proxy/distribution/feed/v1/?fields=abstract%2Ccontributors%2Cdek%2Ckeywords%2Clanguage%2Clast_modified_datetime%2Clead_media%2Clocalizations%2Cmeta%2Cpublication_datetime%2Cseo_title%2Cseries%2Cshort_abstract%2Cshort_title%2Csocial_title%2Csponsor_content%2Ctitle&limit=1&page=2&content_type=article%3Astory&format=jsonapi", "self": "https://relay.nationalgeographic.com/proxy/distribution/feed/v1/?fields=abstract%2Ccontributors%2Cdek%2Ckeywords%2Clanguage%2Clast_modified_datetime%2Clead_media%2Clocalizations%2Cmeta%2Cpublication_datetime%2Cseo_title%2Cseries%2Cshort_abstract%2Cshort_title%2Csocial_title%2Csponsor_content%2Ctitle&limit=1&content_type=article%3Astory&format=jsonapi" }, "jsonapi": { "version": "1.0" } }, "x-stoplight": { "id": "FeedResponse", "name": "FeedResponse", "public": true } }, "Sitemap": { "title": "Sitemap", "type": "object", "properties": { "id": { "type": "string" }, "language": { "type": "string" }, "parent": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "publication_datetime": { "type": "string", "format": "date-time" }, "last_modified_datetime": { "type": "string", "format": "date-time" }, "genres": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": "string" }, "uuid": { "type": "string" } }, "required": [ "name", "uuid" ] } }, "images": { "type": [ "array", "null" ], "items": { "$ref": "#/definitions/ComponentImage" } }, "title": { "type": "string" }, "keywords": { "type": [ "array", "null" ], "items": { "type": [ "string", "array" ], "items": {} } }, "localizations": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "language": { "type": "string" }, "url": { "type": "string", "format": "uri" } }, "required": [ "language", "url" ] } }, "canonical_url": { "type": [ "string", "null" ], "format": "uri" }, "change_frequency": { "type": "string" }, "priority": { "type": "number" } }, "required": [ "id", "language", "url", "publication_datetime", "last_modified_datetime", "images", "title" ], "example": { "id": "5544332", "language": "en_US", "parent": "GS-ES:33", "url": "https://morton.name", "publication_datetime": "4667-02-11T06:36:12.437Z", "last_modified_datetime": "3303-08-17T19:44:44.865Z", "genres": null, "images": [ { "uri": "http://myimage.com/1.jpg", "title": "a title", "source_system": null } ], "title": "est tempor in incididunt", "keywords": [ "travel", "leopard" ], "localizations": [ { "url": "https://agnes.org", "language": "es_AR" } ], "canonical_url": null, "change_frequency": "daily", "priority": 0.8 }, "x-stoplight": { "id": "Sitemap", "name": "Sitemap", "public": true } }, "MagazineIssue": { "title": "MagazineIssue", "allOf": [ { "$ref": "#/definitions/BaseMagazineIssue" }, { "type": "object", "properties": { "magazine": { "type": "object", "properties": { "uuid": { "type": "string" }, "name": { "type": "string" } } } } } ], "example": { "cover_image": { "alt_text": "Picture of the August cover, a supernova in the Milky Way galaxy", "aspect_ratio": 1.454192922927775, "asset_provider": null, "asset_source": null, "caption": "This composite image is of the Crab Nebula, a supernova remnant in the Milky Way galaxy, as viewed by the Herschel Space Observatory and the Hubble Space Telescope.", "credit": "Photo by NASA, ESA", "croppings": [], "height": 3000, "id": "faeff998-1180-48bc-af5e-7e8aa2fdf8fd", "order": 0, "renditions": [ { "density": "1", "media-selector": "(max-width: 130px)", "uri": "http://www.nationalgeographic.com/content/dam/magazine/rights-exempt/2017/08/NGM2017_08_AUGUST_1.adapt.133.1.jpg", "width": "133" } ], "rights_system": null, "source_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "faeff998-1180-48bc-af5e-7e8aa2fdf8fd", "id": "aem-us" }, "title": "On the Cover", "uri": "http://www.nationalgeographic.com/content/dam/magazine/rights-exempt/2017/08/NGM2017_08_AUGUST_1.jpg", "width": 2063 }, "id": "1234", "publication_datetime": "2017-01-01T00:00:01Z", "last_modified_datetime": "2017-01-01T00:00:01Z", "content_type": "magazine:issue", "magazine_id": "magazine:9af83c1e-1fdc-3710-b252-c42eedb1b7c1", "issue_label": "August 2017", "issue_number": "8", "language": "en-US", "magazine": { "name": "Magazine", "uuid": "magazine:9af83c1e-1fdc-3710-b252-c42eedb1b7c1" }, "year": "2017" }, "x-stoplight": { "id": "MagazineIssue", "name": "MagazineIssue", "public": true } }, "CollectionFeaturedImage": { "title": "CollectionFeaturedImage", "allOf": [ { "$ref": "#/definitions/BaseItem" }, { "$ref": "#/definitions/TextAsset" }, { "type": "object", "properties": { "content_type": { "type": "string", "enum": [ "collection:featured_image" ] }, "canonical_url": { "type": "string", "format": "uri" }, "dek": { "type": "string" }, "vanity_url": { "type": "string" } }, "required": [ "content_type" ] } ], "x-stoplight": { "id": "CollectionFeaturedImage", "name": "CollectionFeaturedImage", "public": true } }, "Magazine": { "title": "Magazine", "allOf": [ { "$ref": "#/definitions/BaseItem" }, { "type": "object", "properties": { "content_type": { "type": "string", "enum": [ "magazine" ] }, "name": { "type": "string" }, "source": { "type": "string" } }, "required": [ "content_type", "source", "name" ] } ], "x-stoplight": { "id": "Magazine", "name": "Magazine", "public": true } }, "TaxonomyTopic": { "title": "TaxonomyTopic", "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "uuid": { "type": "string" }, "order": { "type": "integer" } }, "required": [ "name", "uuid" ] }, "x-stoplight": { "id": "TaxonomyTopic", "name": "TaxonomyTopic", "public": true } }, "ComponentVideo": { "title": "ComponentVideo", "type": "object", "properties": { "audio_channels": { "type": [ "string", "null" ] }, "audio_sample_rate": { "type": [ "string", "null" ] }, "bitrate": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "duration": { "type": "integer" }, "expression": { "type": [ "string", "null" ] }, "file_size": { "type": [ "string", "null" ] }, "format": { "type": [ "string", "null" ] }, "frame_rate": { "type": [ "string", "null" ] }, "height": { "type": [ "string", "null" ] }, "language": { "type": [ "string", "null" ] }, "mime_type": { "type": [ "string", "null" ] }, "source_system": { "$ref": "#/definitions/SourceSystem" }, "thumbnail": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string" }, "type": { "type": [ "string", "null" ] }, "uri": { "type": "string" }, "width": { "type": [ "string", "null" ] }, "default": { "type": "boolean" } }, "required": [ "description", "duration", "mime_type", "source_system", "thumbnail", "title", "uri" ], "x-stoplight": { "id": "ComponentVideo", "name": "ComponentVideo", "public": true } }, "ComponentImage": { "title": "ComponentImage", "type": "object", "properties": { "uri": { "type": "string", "format": "uri" }, "title": { "type": [ "string", "null" ] }, "source_system": { "$ref": "#/definitions/SourceSystem" }, "rights_system": { "$ref": "#/definitions/SourceSystem" }, "asset_provider": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "asset_id": { "type": "string" }, "uri": { "type": [ "string", "null" ], "format": "uri" } } }, "alt_text": { "type": [ "string", "null" ] }, "credit": { "type": [ "string", "null" ] }, "caption": { "type": [ "string", "null" ] }, "cropped": { "type": "boolean" }, "aspect_ratio": { "type": "number" }, "height": { "type": "integer" }, "width": { "type": "integer" }, "croppings": { "type": "array", "items": { "type": "object", "properties": { "aspect_ratio_key": { "type": "string" }, "uri": { "type": "string", "format": "uri" }, "instructions": { "type": "object", "required": [ "x_coordinate", "y_coordinate", "height", "width" ], "properties": { "x_coordinate": { "type": "integer" }, "y_coordinate": { "type": "integer" }, "height": { "type": "integer" }, "width": { "type": "integer" } } }, "renditions": { "$ref": "#/definitions/Renditions" } }, "required": [ "aspect_ratio_key", "uri", "instructions" ] } }, "renditions": { "$ref": "#/definitions/Renditions" }, "id": { "type": "string" }, "type": { "type": "string" }, "order": { "type": "integer" } }, "required": [ "uri", "source_system" ], "example": { "alt_text": "Picture of a shark closeup with it's mouth open", "aspect_ratio": 0.66748046875, "asset_provider": null, "asset_source": null, "caption": "A shortfin mako flashes in front of an intruder, introducing itself as a force to be reckoned with in waters off the coast of New Zealand.", "credit": null, "cropped": false, "croppings": [], "height": 1367, "id": "ea82dd15-0ba6-440e-95f4-bfd210be480b", "renditions": [ { "density": "1", "media-selector": "(max-width: 130px)", "uri": "http://www.nationalgeographic.com/content/dam/magazine/rights-exempt/2017/08/Shortfin-Mako/shortfin-mako-jaws-shark.adapt.133.1.jpg", "width": "133" } ], "size": "cinematic", "source_system": { "account": null, "asset_external_field_name": "guid", "asset_id": "ea82dd15-0ba6-440e-95f4-bfd210be480b", "id": "aem-us" }, "title": null, "type": "main", "uri": "http://www.nationalgeographic.com/content/dam/magazine/rights-exempt/2017/08/Shortfin-Mako/shortfin-mako-jaws-shark.jpg", "width": 2048 }, "x-stoplight": { "id": "ComponentImage", "name": "ComponentImage", "public": true } }, "ComponentAudio": { "title": "ComponentAudio", "description": "Audio component.", "type": "object", "properties": { "source_system": { "$ref": "#/definitions/SourceSystem" }, "url": { "type": "string", "format": "url" }, "alt_text": { "type": "string" }, "duration": { "type": [ "integer", "null" ], "description": "Audio duration in ms." }, "mime_type": { "type": "string", "enum": [ "audio/mp3" ] }, "title": { "type": [ "string", "null" ] }, "heading": { "type": [ "string", "null" ] }, "caption": { "type": [ "string", "null" ] }, "credit": { "type": [ "string", "null" ] }, "thumbnail": { "$ref": "#/definitions/ComponentImage" }, "asset_source": { "type": [ "string", "null" ] }, "show_title": { "type": "boolean", "default": true }, "show_caption": { "type": "boolean", "default": true }, "show_credit": { "type": "boolean", "default": true }, "show_thumbnail": { "type": "boolean", "default": true } }, "required": [ "source_system", "url", "alt_text" ], "example": { "title": "This is a title", "heading": "This is a bold statement!", "caption": "Lorem ipsum", "credit": "This is the credit", "asset_source": "This is the asset source", "alt_text": "Lorem ipsum", "duration": 481516, "url": "http://news.int.ngeo.com/news/audio/2017/05/18/sound_garden.mp3", "mime_type": "audio/mp3", "source_system": { "id": "aem-us", "asset_id": "64910ef1-ad3e-4235-90eb-ff5b32608739", "account": null, "asset_external_field_name": "guid" }, "thumbnail": { "id": "64910ef1-ad3e-4235-90eb-ff5b32608739", "uri": "http://news-qa6.int.ngeo.com/content/dam/news/2017/02/16/w&w/wild-dupers.jpg", "caption": "A painted frogfish, Antennarius pictus, at Omaha's Henry Doorly Zoo and Aquarium.", "title": "wild-dupers", "credit": "Photograph by Joel Sartore, National Geographic Photo Ark", "alt_text": "Picture of orange duper fish", "aspect_ratio": 0.66552734375, "height": 1363, "width": 2048, "size": "small", "cropped": false, "source_system": { "id": "aem-us", "asset_id": "64910ef1-ad3e-4235-90eb-ff5b32608739", "account": null, "asset_external_field_name": "guid" }, "asset_provider": { "id": "ngs_rights_vendor:SPI", "asset_id": "1924160", "uri": null }, "renditions": [ { "width": "133", "uri": "http://news-qa6.int.ngeo.com/content/dam/news/2017/02/16/w&w/wild-dupers.adapt.133.1.jpg", "density": "1", "media-selector": "(max-width: 130px)" }, { "width": "1900", "uri": "http://news-qa6.int.ngeo.com/content/dam/news/2017/02/16/w&w/wild-dupers.adapt.1900.1.jpg", "density": "1", "media-selector": "(max-width: 1900px)" } ], "croppings": [], "type": "inline" }, "show_title": true, "show_caption": true, "show_credit": false, "show_thumbnail": true }, "x-stoplight": { "id": "ComponentAudio", "name": "ComponentAudio", "public": true } }, "ComponentKicker": { "title": "ComponentKicker", "description": "kicker component", "type": "object", "properties": { "genre": { "type": "object", "properties": { "hide": { "type": "boolean", "default": false }, "name": { "type": [ "string", "null" ] }, "uri": { "type": [ "string", "null" ], "format": "uri" }, "taxonomy_id": { "type": [ "string", "null" ] } }, "required": [ "hide" ] }, "mini-franchise": { "type": "object", "properties": { "hide": { "type": "boolean", "default": false }, "name": { "type": [ "string", "null" ] }, "uri": { "type": [ "string", "null" ], "format": "uri" }, "taxonomy_id": { "type": [ "string", "null" ] } }, "required": [ "hide" ] }, "series": { "type": "object", "properties": { "hide": { "type": "boolean", "default": false }, "name": { "type": [ "string", "null" ] }, "uri": { "type": [ "string", "null" ], "format": "uri" }, "taxonomy_id": { "type": [ "string", "null" ] } }, "required": [ "hide" ] }, "source": { "type": "object", "properties": { "hide": { "type": "boolean", "default": false }, "name": { "type": [ "string", "null" ] }, "uri": { "type": [ "string", "null" ], "format": "uri" }, "taxonomy_id": { "type": [ "string", "null" ] } }, "required": [ "hide" ] } }, "example": { "genre": { "hide": false, "name": "Genre Name", "taxonomy_id": "e823fa97-02d6-4601-9d92-52cf7ab9cbaa", "uri": "https://www.nationalgeographic.com/some-link-to-genre-page/" }, "mini-franchise": { "hide": false, "name": "Mini-Franchise Name", "uri": "http://www.natgeo.com/some-link-to-mini-franchise-page" }, "series": { "hide": false, "name": "Series Name", "uri": "http://www.natgeo.com/some-link-to-series-page" }, "source": { "hide": false, "name": "Source Name", "uri": "http://www.natgeo.com/some-link-top-source-page" } }, "x-stoplight": { "id": "ComponentKicker", "name": "ComponentKicker", "public": true } }, "ComponentDek": { "title": "ComponentDek", "description": "Dek Component", "type": "object", "properties": { "text": { "type": [ "string", "null" ] }, "hide": { "type": "boolean", "default": false } }, "required": [ "hide" ], "example": { "text": "

These 18 Autochrome Photos Will Transport You to Another Era

", "hide": true }, "x-stoplight": { "id": "ComponentDek", "name": "ComponentDek", "public": true } }, "ComponentTitle": { "title": "ComponentTitle", "description": "title component", "type": "object", "properties": { "text": { "type": "string" }, "hide": { "type": "boolean", "default": false }, "size": { "type": [ "string", "null" ], "enum": [ "XS", "S", "M", "L", "FULL" ], "default": "M" }, "style": { "type": "string", "enum": [ "all-caps", "sentence-case" ], "default": "sentence-case" } }, "required": [ "hide", "size", "style" ], "example": { "text": "This Story is about Tigers", "hide": true, "size": "M", "style": "all-caps" }, "x-stoplight": { "id": "ComponentTitle", "name": "ComponentTitle", "public": true } }, "ComponentPublishDate": { "title": "ComponentPublishDate", "description": "publish_date component", "type": "object", "properties": { "display_date": { "type": "string" }, "hide": { "type": "boolean", "default": false } }, "required": [ "hide", "display_date" ], "example": { "display_date": "November 11, 2017", "hide": false }, "x-stoplight": { "id": "ComponentPublishDate", "name": "ComponentPublishDate", "public": true } }, "ComponentTwitterTweet": { "title": "ComponentTwitterTweet", "description": "twitter_tweet component", "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ], "example": { "url": "https://twitter.com/AppStore/status/591656099792683008" }, "x-stoplight": { "id": "ComponentTwitterTweet", "name": "ComponentTwitterTweet", "public": true } }, "ComponentInstagramMedia": { "title": "ComponentInstagramMedia", "description": "instagram_media component", "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "media_id": { "type": "string" }, "user_id": { "type": "string" } }, "required": [ "url" ], "example": { "url": "https://instagram.com/p/1yHWrys9M-/", "media_id": "123456", "user_id": "456789" }, "x-stoplight": { "id": "ComponentInstagramMedia", "name": "ComponentInstagramMedia", "public": true } }, "ComponentFacebookPost": { "title": "ComponentFacebookPost", "description": "facebook_post component", "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "profile_id": { "type": "string" }, "post_id": { "type": "string" } }, "required": [ "url" ], "example": { "url": "https://www.facebook.com/car2go/posts/10155132644617222", "profile_id": "111728637221", "post_id": "10155132644617222" }, "x-stoplight": { "id": "ComponentFacebookPost", "name": "ComponentFacebookPost", "public": true } } }, "x-stoplight": { "version": { "groups": { "utilFuncs": [], "savedEntries": [], "tests": [], "traits": [], "docs": [ { "name": "Endpoints", "items": [ { "type": "endpoints", "_id": "GET_feed-v1" } ], "divider": false }, { "name": "API Response", "items": [ { "type": "schemas", "_id": "FeedResponse" }, { "type": "endpoints", "_id": "3p8pL9QpoAvwnyBSG" }, { "type": "endpoints", "_id": "T28jgK2rYC7Zc6XXS" }, { "type": "endpoints", "_id": "Nh5cSDRqmbZYir5Fm" }, { "type": "endpoints", "_id": "WnD3h47rvi5r7tnn3" }, { "type": "endpoints", "_id": "k7cpg3wGowtjuyPwh" } ], "divider": false }, { "description": "Main content types that can be distributed through Distribution", "name": "Assets", "items": [ { "type": "schemas", "_id": "Article" }, { "type": "schemas", "_id": "MagazineIssue" }, { "type": "endpoints", "_id": "NDzBBDALz9m4Puf8N" }, { "type": "endpoints", "_id": "J9j3vj8rneeNfWfB4" } ], "divider": false }, { "name": "Utils", "items": [ { "type": "schemas", "_id": "StoryRelationshipTopic" }, { "type": "schemas", "_id": "TaxonomyRelationshipTopic" } ], "divider": false } ] } }, "functions": {}, "textSections": {}, "mock": { "dynamic": false, "enabled": false } }, "x-tests": {} }