MSU Libraries Catalog Search Response

JSON Schema for the SearchResponse object returned by the MSU Libraries VuFind REST API /search and /record endpoints. Derived from the published OpenAPI 3.0.3 SearchResponse schema.

EducationHigher EducationUniversityLibraryOpen DataMetadataUnited StatesMichigan

Properties

Name Type Description
resultCount integer Number of results
records array Records
facets array Facets
resumptionToken object Token for retrieving the next batch of results
status string Status code
View JSON Schema on GitHub

JSON Schema

michigan-state-university-searchresponse-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/michigan-state-university/main/json-schema/michigan-state-university-searchresponse-schema.json",
  "title": "MSU Libraries Catalog Search Response",
  "description": "JSON Schema for the SearchResponse object returned by the MSU Libraries VuFind REST API /search and /record endpoints. Derived from the published OpenAPI 3.0.3 SearchResponse schema.",
  "type": "object",
  "required": ["resultCount", "status"],
  "properties": {
    "resultCount": {
      "type": "integer",
      "description": "Number of results"
    },
    "records": {
      "type": "array",
      "description": "Records",
      "items": { "$ref": "https://raw.githubusercontent.com/api-evangelist/michigan-state-university/main/json-schema/michigan-state-university-record-schema.json" }
    },
    "facets": {
      "type": "array",
      "description": "Facets",
      "items": { "$ref": "#/$defs/Facet" }
    },
    "resumptionToken": {
      "type": "object",
      "description": "Token for retrieving the next batch of results",
      "properties": {
        "token": { "type": "string", "description": "Token to use for the next request" },
        "expires": { "type": "string", "format": "date-time", "description": "Time when the token expires" }
      }
    },
    "status": {
      "type": "string",
      "description": "Status code",
      "enum": ["OK"]
    }
  },
  "$defs": {
    "Facet": {
      "type": "object",
      "properties": {
        "value": { "type": "string", "description": "Facet value" },
        "translated": { "type": "string", "description": "Translated facet value" },
        "count": { "type": "integer", "description": "Count of records found if the facet is added as a filter" },
        "href": { "type": "string", "description": "The current search with the facet added as a filter" },
        "isApplied": { "type": "boolean", "description": "True if the facet is in use in the filter parameter of the query" },
        "children": {
          "type": "array",
          "description": "For hierarchical facets, any child facets",
          "items": { "$ref": "#/$defs/Facet" }
        }
      }
    }
  }
}