Detail

Subject: Detail

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

The Service Detail resource return the detail of a selected service.

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "http://schema.pressassociation.io/content/ninjs/pa-ninjs-schema_1.2.json#",
  "type": "object",
  "title": "PA IPTC ninjs - News in JSON - version 1.1 (Derived from IPTC - News in JSON - version 1.1)",
  "description": "A Press Association (PA) modification to the news item as JSON object -- copyright 2014 IPTC - International Press Telecommunications Council - www.iptc.org - Original document is published under the Creative Commons Attribution 3.0 license, see  http://creativecommons.org/licenses/by/3.0/  $$comment: as of 2014-03-13 ",
  "additionalProperties": false,
  "required": ["uri"],
  "patternProperties": {
    "^description_[a-zA-Z0-9_]+": {
      "description": "A free-form textual description of the content of the item. (The string appended to description_ in the property name should reflect the format of the text)",
      "type": "string"
    },
    "^body_[a-zA-Z0-9_]+": {
      "description": "The textual content of the news object. (The string appended to body_ in the property name should reflect the format of the text)",
      "type": "string"
    }
  },
  "properties": {
    "uri": {
      "description": "The identifier for this news object",
      "type": "string"
    },
    "type": {
      "description": "The generic news type of this news object",
      "type": "string",
      "enum": ["text", "audio", "video", "picture", "graphic", "composite", "social", "quiz", "big-number", "fact-box", "quote"]
    },
    "mimetype": {
      "description": "A MIME type which applies to this news object",
      "type": "string"
    },
    "representationtype": {
      "description": "Indicates how complete this representation of a news item is",
      "type": "string",
      "enum": ["complete", "incomplete"]
    },
    "profile": {
      "description": "An identifier for the kind of content of this news object",
      "type": "string"
    },
    "version": {
      "description": "The version of the news object which is identified by the uri property",
      "type": "string"
    },
    "versioncreated": {
      "description": "The date and time when this version of the news object was created",
      "type": "string",
      "format": "date-time"
    },
    "firstcreated": {
      "description": "The date and time when the first version of the news object was created",
      "type": "string",
      "format": "date-time"
    },
    "embargoed": {
      "description": "The date and time before which all versions of the news object are embargoed. If absent, this object is not embargoed.",
      "type": "string",
      "format": "date-time"
    },
    "pubstatus": {
      "description": "The publishing status of the news object, its value is *usable* by default.",
      "type": "string",
      "enum": ["usable", "withheld", "canceled"]
    },
    "urgency": {
      "description": "The editorial urgency of the content from 1 to 9. 1 represents the highest urgency, 9 the lowest.",
      "type": "number"
    },
    "ranking": {
      "description": "A value for comparing the importance of this news object compared to other news objects. 1 represents the highest ranking. Only postive integers are allowed.",
      "type": "number"
    },
    "copyrightholder": {
      "description": "The person or organisation claiming the intellectual property for the content.",
      "type": "string"
    },
    "copyrightnotice": {
      "description": "Any necessary copyright notice for claiming the intellectual property for the content.",
      "type": "string"
    },
    "usageterms": {
      "description": "A natural-language statement about the usage terms pertaining to the content.",
      "type": "string"
    },
    "language": {
      "description": "The human language used by the content. The value should follow IETF BCP47",
      "type": "string"
    },
    "person": {
      "description": "An individual human being",
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The name of a person",
            "type": "string"
          },
          "rel": {
            "description": "The relationship of the content of the news object to the person",
            "type": "string"
          },
          "scheme": {
            "description": "The identifier of a scheme (= controlled vocabulary) which includes a code for the person",
            "type": "string",
            "format": "uri"
          },
          "code": {
            "description": "The code for the person in a scheme (= controlled vocabulary) which is identified by the scheme property",
            "type": "string"
          },
          "profile": {
            "description": "An identifier for the CV that defines this person.",
            "type": "string"
          }
        }
      }
    },
    "organisation": {
      "description": "An administrative and functional structure which may act as as a business, as a political party or not-for-profit party",
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The name of the organisation",
            "type": "string"
          },
          "rel": {
            "description": "The relationship of the content of the news object to the organisation",
            "type": "string"
          },
          "scheme": {
            "description": "The identifier of a scheme (= controlled vocabulary) which includes a code for the organisation",
            "type": "string",
            "format": "uri"
          },
          "code": {
            "description": "The code for the organisation in a scheme (= controlled vocabulary) which is identified by the scheme property",
            "type": "string"
          },
          "profile": {
            "description": "An identifier for the CV that defines this organisation.",
            "type": "string"
          },
          "symbols": {
            "description": "Symbols used for a finanical instrument linked to the organisation at a specific market place",
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "ticker": {
                  "description": "Ticker symbol used for the financial instrument",
                  "type": "string"
                },
                "exchange": {
                  "description": "Identifier for the marketplace which uses the ticker symbols of the ticker property",
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "place": {
      "description": "A named location",
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "patternProperties": {
          "^geometry_[a-zA-Z0-9_]+": {
            "description": "An object holding geo data of this place. Could be of any relevant geo data JSON object definition.",
            "type": "object"
          }
        },
        "properties": {
          "name": {
            "description": "The name of the place",
            "type": "string"
          },
          "rel": {
            "description": "The relationship of the content of the news object to the place",
            "type": "string"
          },
          "scheme": {
            "description": "The identifier of a scheme (= controlled vocabulary) which includes a code for the place",
            "type": "string",
            "format": "uri"
          },
          "code": {
            "description": "The code for the place in a scheme (= controlled vocabulary) which is identified by the scheme property",
            "type": "string"
          },
          "profile": {
            "description": "An identifier for the CV that defines this place.",
            "type": "string"
          }
        }
      }
    },
    "subject": {
      "description": "A concept with a relationship to the content",
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The name of the subject",
            "type": "string"
          },
          "rel": {
            "description": "The relationship of the content of the news object to the subject",
            "type": "string"
          },
          "scheme": {
            "description": "The identifier of a scheme (= controlled vocabulary) which includes a code for the subject",
            "type": "string",
            "format": "uri"
          },
          "code": {
            "description": "The code for the subject in a scheme (= controlled vocabulary) which is identified by the scheme property",
            "type": "string"
          },
          "profile": {
            "description": "An identifier for the CV that defines this subject.",
            "type": "string"
          }
        }
      }
    },
    "event": {
      "description": "Something which happens in a planned or unplanned manner",
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The name of the event",
            "type": "string"
          },
          "rel": {
            "description": "The relationship of the content of the news object to the event",
            "type": "string"
          },
          "scheme": {
            "description": "The identifier of a scheme (= controlled vocabulary) which includes a code for the event",
            "type": "string",
            "format": "uri"
          },
          "code": {
            "description": "The code for the event in a scheme (= controlled vocabulary) which is identified by the scheme property",
            "type": "string"
          },
          "profile": {
            "description": "An identifier for the CV that defines this event.",
            "type": "string"
          }
        }
      }
    },
    "object": {
      "description": "Something material, excluding persons",
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The name of the object",
            "type": "string"
          },
          "rel": {
            "description": "The relationship of the content of the news object to the object",
            "type": "string"
          },
          "scheme": {
            "description": "The identifier of a scheme (= controlled vocabulary) which includes a code for the object",
            "type": "string",
            "format": "uri"
          },
          "code": {
            "description": "The code for the object in a scheme (= controlled vocabulary) which is identified by the scheme property",
            "type": "string"
          },
          "profile": {
            "description": "An identifier for the CV that defines this object.",
            "type": "string"
          }
        }
      }
    },
    "byline": {
      "description": "The name(s) of the creator(s) of the content",
      "type": "string"
    },
    "headline": {
      "description": "A brief and snappy introduction to the content, designed to catch the reader's attention",
      "type": "string"
    },
    "located": {
      "description": "The name of the location from which the content originates.",
      "type": "string"
    },
    "dates": {
      "description": "All dates pertaining to the event (or the event of the item), in particular the start date and a duration or a set end date",
      "type": "object",
      "additionalProperties": false,
      "required": ["start"],
      "properties": {
        "start": {
          "description": "The date and time the event commences.",
          "type": "string",
          "format": "date-time"
        },
        "end": {
          "description": "The date and time the event ends.",
          "type": "string",
          "format": "date-time"
        },
        "duration": {
          "description": "The period the event will last, expressed as a duration where the highest level is a day, e.g. P2D, PT10H, PT15M",
          "type": "string",
          "pattern": "P(?!$)(\\d+D)?(T(?=\\d)(\\d+H)?(\\d+M)?(\\d+\\.)?(\\d+S)?)?"
        }
      }
    },
    "renditions": {
      "description": "Wrapper for different renditions of non-textual content of the news object",
      "type": "object",
      "additionalProperties": false,
      "patternProperties": {
        "^[a-zA-Z0-9]+": {
          "description": "A specific rendition of a non-textual content of the news object.",
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "href": {
              "description": "The URL for accessing the rendition as a resource",
              "type": "string",
              "format": "uri"
            },
            "mimetype": {
              "description": "A MIME type which applies to the rendition",
              "type": "string"
            },
            "title": {
              "description": "A title for the link to the rendition resource",
              "type": "string"
            },
            "height": {
              "description": "For still and moving images: the height of the display area measured in pixels",
              "type": "number"
            },
            "width": {
              "description": "For still and moving images: the width of the display area measured in pixels",
              "type": "number"
            },
            "sizeinbytes": {
              "description": "The size of the rendition resource in bytes",
              "type": "number"
            },
            "poi": {
              "description": "The point of interest of the rendition.",
              "type": "object",
              "properties": {
                "x": {
                  "description": "The x co-ordinate of the point of interest.",
                  "type": "number"
                },
                "y": {
                  "description": "The y co-ordinate of the point of interest.",
                  "type": "number"
                }
              }
            },
            "orientation": {
              "type": "string",
              "description": "The orientation of the rendition",
              "enum": ["landscape", "portrait", "square"]
            }
          }
        }
      }
    },
    "associations": {
      "description": "Content of news objects which are associated with this news object.",
      "type": "object",
      "additionalProperties": false,
      "patternProperties": {
        "^[a-zA-Z0-9]+": {
          "$ref": "http://schema.pressassociation.io/content/ninjs/pa-ninjs-schema_1.1.json#"
        }
      }
    },
    "links": {
      "description": "HATEOAS style links related to the news object.",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "rel": {
          "description": "The relationship of the link to the news object.",
          "type": "string"
        },
        "href": {
          "description": "The URL for accessing the link.",
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Path Params
string
required

The identifier of the Subject

Query Params
string
Defaults to json

The format to render the response. Possible values (json, atom, rss).

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/xml