API functions are accessed by appending /api/ to the primary URL of the site, e.g. the-fr.org, and further, appending the documented strings below, depending on the function you wish to access.
The following is an exhaustive list of the functionality supported by the-fr.org:
Alternative identifications schemes allow users to explore the-fr.org using known file-format identifiers.
Currently supported are PRONOM unique identifiers. In future identifiers such as UDFR will be supported.
URI examples are as follows:
/api/id/puid/fmt/8
/api/id/udfr/u1f378
PUIDS: PRONOM Unique Identifiers
There are two types of PUID, fmt, and x-fmt. You can access records matching a published PUID using the following notation:
/api/id/puid/fmt/{no}
/api/id/puid/x-fmt/{no}
And:
/api/id/puid/xfmt/{no}
the-fr.org examples:
Return types
The function will currently re-direct the agent to the record matching the requested PUID.
N.B. It may be necessary to eventually provide agents using this function call with a listing page where a PUID matches multiple the-fr.org records.
DROID Compatibility
the-fr.org PUID search is compatible with the DROID tool , developed by The National Archives, UK. Open the tool, browse to Tools->Preferences->'Signature Updates' and change the PUID URL Pattern from:
http://www.nationalarchives.gov.uk/pronom/%s
to:
http://the-fr.org/api/id/puid/%s
N.B. You might need to open a new DROID profile before changes take effect.
Product of: