unAPI Server for WordPress
The unAPI Server is a WordPress plug-in implementing the final version of the unAPI specification, "a tiny HTTP API for the few basic operations necessary to copy discrete, identified content from any kind of web application." Read the final version of the unAPI spec. This is the "official" site of the unAPI WP plug-in.
The server provides records for each WordPress post and page in the following formats: OAI-Dublin Core (oai_dc), Metadata Object Description Schema (MODS), SRW-Dublin Core (srw_dc), MARCXML, and RSS. The specification makes use of LINK tag auto-discovery and an unendorsed microformat for machine-readable metadata records.
Download
- Download the unAPI Server for WordPress plug-in (8KB Zip)
- Or check it out of the wp-plugins.org Subversion repository:
svn co http://svn.wp-plugins.org/unapi/trunk unapi
Install
- Upload the unapi folder containing all source files to your plug-ins folder, usually 'wp-content/plugins/' — ensure that the folder is named 'unapi' (not, 'unapi-wordpress' or 'trunk')
- Login as an administrator and activate the plug-in via the Plugins menu
- [OPTIONAL] Choose an identifier prefix — an arbitrary string — and enter it via the unAPI submenu of the Options menu (but the default will likely work for you)
- Voila! All of the posts in your WordPress blog are now published via unAPI.
Frequently Asked Questions
- unAPI? What the heck is that? This is a glib answer, and a none-too-useful one at that. But you might hazard a peek at the following Ariadne article for more information:http://www.ariadne.ac.uk/issue48/chudnov-et-al/
- Hey, nothing's different. What gives? I said machine-readable, right? Be glad; we've verified you're not a machine. :)In order to see unAPI in action, you may install an unAPI client such as these Greasemonkey scripts (requiring Firefox, unless you can get them to work in Turnabout):* By Xiaoming Liu:
http://lxming.blogspot.com/2006_05_21_lxming_archive.html* By Alf Eaton:
http://cipolo.med.yale.edu/pipermail/gcs-pcs-list/2006-June/000951.html - Yeah, but is it really working? If you'd like, you may validate your unAPI service by entering a post URL — any regular WP post URL will do — over at http://validator.unapi.info/
- What should I use for my identifier prefix? An unAPI identifier is typically composed of a prefix and an integer, but may be any string. Since WordPress already identifies individual posts with a locally unique integer, we only need to tack on a prefix. The default should work for you, but you can feel free to change it. Some folks prefer OAI-interoperable identifiers such as oai:domain.tld:blogname:. Others opt for simplicity, such as the default prefix, based on your permalink structure. It really is up to you; democracy, ho! If I were you, I'd just leave the default — it's perty.
- Help! Something is broked! Go tell it on the mountain, brother! Oh, okay, why don't you send me an e-mail? Try leftwing {at} alumni[ dawt ]rutgers (d0t) edu. Patches welcome.
Example unAPI responses
- type 1 url, requesting available formats
- type 2 url, requesting formats available for a post
- type 3 url, requesting a MODS record for a post
- type 3 url, requesting an MARCXML record for a post
- some bad urls: non-existent identifier (404), non-existent format (406), format provided without identifier (400)
Acknowledgements
pbinkley wrote the original unAPI for WordPress plug-in, and much of his code remains in the current revision. A hearty tip of the hat to Peter Binkley!
Feed
[...] The unAPI plug-in for WordPress has moved to the following location: http://www.lackoftalent.org/michael/blog/unapi-wordpress-plug-in/ As indicated in my prior post, the WordPress plug-in for unAPI service developed by pbinkley has been updated to reflect changes to the unAPI spec through to the current revision. Download the plug-in. [...]
[...] The page for the unAPI WordPress plug-in has moved to the following location: http://www.lackoftalent.org/michael/blog/unapi-wordpress-plug-in/ [...]
[...] The WordPress plug-in for unAPI now lives here: http://www.lackoftalent.org/michael/blog/unapi-wordpress-plug-in/ [...]
links for 2006-06-30
Open Repository (tags: Open_Repository dspace) Tame The Web: Libraries and Technology: TTW Mailbox: Selling RSS to Medical Librarians (Updated) (tags: Medical_Libraries RSS) The Chronicle: 6/23/2006: Lost in a Sea of Science Data "We are starting to …
[...] WP Plugin: unAPI Server unAPI is "a tiny HTTP API for the few basic operations necessary to copy discrete, identified content from any kind of web application." Use this plugin to implement the final version of the unAPI specs. The specification makes use of LINK tag auto-discovery and an unendorsed microformat for machine-readable metadata records. (No Ratings Yet) Loading … [...]
[...] Michael's Blog | unAPI -Info [...]
[...] To invoke the service, I installed the unAPI Server, a WordPress plug-in from Michael J. Giarlo. The server provides records for each WordPress post and page in the following formats: OAI-Dublin Core (oai_dc), Metadata Object Description Schema (MODS), SRW-Dublin Core (srw_dc), MARCXML, and RSS. The specification makes use of LINK tag auto-discovery and an unendorsed microformat for machine-readable metadata records. [...]
[...] Des de fa uns dies aquest blog implementa un servidor unAPi mitjançant el plugin unAPI Server for WordPress que permet accedir als continguts de manera estructurada. [...]
[...] Auf heise ist wieder etwas zur Archivierung von Netzpublikationen durch die Deutsche Nationalbibliothek (DNB) zu lesen. Die DNB betreibt ein Informationsportal zur Ablieferung von Publikationen, die im Netz erscheinen. Mit dem im Juni 2006 geänderten Gesetz über die Deutsche Nationalbibliothek (DNBG) fallen diese Werke auch unter den Sammelauftrag der DNB. Näheres soll die Pflichtabgabeverordnung klären, die heise im Entwurf vorliegt - allerdings ist der Entwurf anscheinend nicht öffentlich, kann das bitte jemand online stellen? Bis es soweit ist, werde ich mal schauen, wie die Ablieferung von Weblogs am Besten zu bewerkstelligen ist. Dass die DNB selber die Feeds sammeln wird, bezweifle ich (obwohl es die einfachste Variante wäre). Vielleicht hilft das unAPI-Plugin weiter, dass von Mike Giarlo betreut wird, der mit Technosophia mit einen schönen Tech-Librarian-Weblog betreib. Das Zusammenpacken und Bereitstellen der Postings eines ausgewählten Zeitraums dürfte mit einem passenden Plugin kein Problem sein; der Teufel steckt aber wahrscheinlich im Detail. Tags: archivierung, Bibliothek, blogs, dnb | Siehe auch: Datenvisualisierung mit Digg Labs, GE Earth, Many Eyes, Swivel etc. (23. Mai 2007), ISBN in Wikipedia - eine Analyse (19. Mai 2007), LibraryThing für Bibliotheken (18. Mai 2007), Wer ist 2007 Bundeskanzler von Deutschland? (12. Mai 2007), Studierende in Konstanz für mehr Gebühren? (10. Mai 2007) [...]
[...] Visit [...]
unAPI is working perfectly (except for a couple of glitches)!!!! Nice work.
[...] There is a plugin (by Peter Binkley and Mike Giarlo) for WordPress that provides records for posts in OAI-Dublin Core, MODS, SRW-Dublin Core, MARCXML and RSS. I don't know if Beyond Brown Paper is using this plugin, but it would lend some additional publishing functionality to enable a WordPress image collection like this to integrate with other systems. I imagine it could be used to publish oai output for a service like Picture Australia. [...]
[...] Visit [...]
[...] The other day Peta posted an item here about the Beyond Paper Bag project. In it she mentioned the unAPI plugin for WordPress. WordPress is the software that we use here to run the blog. [...]
[...] The other day Peta posted an item over at librariesinteract.info about the Beyond Paper Bag project. In it she mentioned the unAPI plugin for WordPress. WordPress is the software that we use here to run the blog. [...]
[...] crossed my fingers and it turns out the unAPI server plug-in still works in WP2.3. Huzzah! Not sure if it works in the 2.1 or 2.2 branches, but I suspect it [...]