Skip to content

Interconnecting iQvoc

mrreynolds edited this page Feb 28, 2012 · 25 revisions

iQvoc provides adaptors in order to make interconnecting several instances of iQvoc via it's REST APIs easy. The following list provides information on the REST API resources themselves as well as on the encapsulation within adaptors.

Remote Search

Find concept URIs in another instance of iQvoc based on an ommitted label value.

Adaptor

Initializing an adaptor instance is easy: Just provide a named alias for your remote target instance of iQvoc and an optional URI. The URI parameter is optional; the adaptor class looks for a configured value in Iqvoc.config["adaptors.iqvoc.#{name.to_s.underscore}"].

require 'iqvoc/adaptors/iqvoc'

adaptor = Iqvoc::Adaptors::Iqvoc.new(:your_desired_name, "http://your-iqvoc-instance.company.net/")
adaptor.search("foo")
# => "{'http://your-iqvoc-instance.company.net/concepts/foo' => 'foo'}"

GET /search.json

Parameters

q required
Search query. Should be URL-encoded.

qt required
Query type. Sets the string matching used for searching.
Possible Values: exact, contains, begins_with, ends_with

l required
Languages for labels. Multiple values can be ommitted comma-separated but must be URI-encoded. Examples: en, en%2Cde