Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
VersionStatusMaturityComments
1.0-SNAPSHOTUnder testingRelease candidate 
Note

UNDER CONSTRUCTION FOR NEW VERSION OF DATA API

...

The HTRC Data API is a RESTful web service for the retrieval of multiple volumes, pages of volumes, and METS metadata documents.

API

Retrieve Volumes

DescriptionReturns requested volumes
URL
/volumes
Supported Response Types
application/zip (normal response)
text/html (error response)
MethodPOST
Request Types
application/x-www-form-urlencoded
Request BodyRequest parameters as body content.  See Parameters below
Parameters
NameDescriptionTypeDefault valueRequiredNote
volumeIDsThe list of volumeIDs to be retrieved.stringN/AyesVolumeIDs are separated by the pipe character '|'
concatThe flag to indicate concatenation option.booleanfalsenoSee section on response format for details on its impact on the returned data
metsThe flag to indicate if METS document should be returnedbooleanfalseno 
versionThe specific version of the Data API to usestringN/AnoNot implemented.  Place holder only
      
Responses
HTTP Status CodeResponse BodyResponse TypeDescription
200 (ok)A binary Zip stream
application/zip
Page content and metadata of the requested volumes aggregated as a Zip stream
400 (bad request)<p>Missing required parameter volumeIDs</p>
text/html
The required parameter volumeIDs is missing in the request
400 (bad request)<p>Malformed Volume ID list. Offending token: ${token}</p>
text/html
The value for volumeIDs is malformed and the Data API cannot parse it.  ${token} will be the token that causes the error.
    
  

 

1.1 OAuth2 Authentication

...