ShareDoc:Search API - Revision history

Massimiliano Branca at 12:39, 3 July 2026

2026-07-03T12:39:40Z

← Older revision		Revision as of 12:39, 3 July 2026
Line 67:		Line 67:
	fixed). Check its status before relying on it in an integration.		fixed). Check its status before relying on it in an integration.
	</div>		</div>



Line 238:		Line 239:
	*[https://sit2-base-svde.atcult.it/agents.json?q=carto&mode=typeahead&fuzzy=false Agents typeahead search using '''carto''' (no fuzzy)]		*[https://sit2-base-svde.atcult.it/agents.json?q=carto&mode=typeahead&fuzzy=false Agents typeahead search using '''carto''' (no fuzzy)]
	*[https://sit2-base-svde.atcult.it/agents/201.json Lewis Carroll]		*[https://sit2-base-svde.atcult.it/agents/201.json Lewis Carroll]
			===Works by an agent vs. works about an agent===
			For each agent type (<code>agents</code>, <code>people</code>, <code>organizations</code>, <code>meetings</code>, <code>families</code>) there are two distinct navigations, not to be confused:
			* <code>GET /{type}/{id}/opuses</code> — works the agent is the '''author/contributor''' of.
			*<code>GET /{type}/{id}/opuses/about</code> — works that have the agent '''as their subject''' (the
			agent is the topic of the work, not its author).
			Parameters of <code>/opuses/about</code> (all optional): <code>sort</code>, <code>rows</code>, <code>offset</code>, <code>filter</code> (repeatable).

			Example: <code>GET /people/{id}/opuses</code> returns the books written by a person; <code>GET /people/{id}/opuses/about</code> returns the books written '''about''' that person.
	==<span id="Person" class="mw-headline"><span id="Agent" class="mw-headline">Person</span></span>==		==<span id="Person" class="mw-headline"><span id="Agent" class="mw-headline">Person</span></span>==
	A person is an individual or identity established by an individual (either alone or in collaboration with one or more other individuals). It is a concrete subclass of Agent and provides a set of attributes, both datatype and object properties which interconnect the entity to opuses and other bibliographic entities in the Share-VDE domain model.		A person is an individual or identity established by an individual (either alone or in collaboration with one or more other individuals). It is a concrete subclass of Agent and provides a set of attributes, both datatype and object properties which interconnect the entity to opuses and other bibliographic entities in the Share-VDE domain model.
Line 1,260:		Line 1,269:

	Returns the publication associated with the given identifier.		Returns the publication associated with the given identifier.
			===Similar publications: /publications/{id}/like===
			Returns publications '''similar''' to a given publication.

			<code>GET /publications/{id}/like</code>

			Parameters (optional): <code>sort</code>, <code>rows</code> (default 10), <code>offset</code> (default 0), <code>filter</code> (repeatable), <code>refinementQuery</code>. The response includes <code>totalMatches</code>.
	==<span id="Controlled_Vocabulary_Entities" class="mw-headline">Controlled Vocabulary Entities</span>==		==<span id="Controlled_Vocabulary_Entities" class="mw-headline">Controlled Vocabulary Entities</span>==
	Other than the entities described above, referred as "core entities", the Share-VDE domain model includes some other entities that are gathered from external sources, assigned a Share-VDE URI and linked to core entities.		Other than the entities described above, referred as "core entities", the Share-VDE domain model includes some other entities that are gathered from external sources, assigned a Share-VDE URI and linked to core entities.

Massimiliano Branca at 10:13, 3 July 2026

2026-07-03T10:13:54Z

Show changes

Massimiliano Branca: /* Resource */

2026-07-03T10:12:44Z

Resource

Show changes

Massimiliano Branca at 07:51, 3 July 2026

2026-07-03T07:51:20Z

Massimiliano Branca at 07:50, 3 July 2026

2026-07-03T07:50:49Z

Show changes

Serena Cericola: Created page with "==Stats== The /stats endpoint returns high-level aggregations about the whole knowledge base. There's an "extended" boolean parameter which drives the response format, specifically: When it is set to false, the response is very concise, see the following example: { "item": 137, "agent": { "person": 54, "organization": 16, "family": 16, "meeting": 9 }, "instance": 146, "opus": 120,..."

2024-02-20T15:24:48Z

Created page with "==<span class="mw-headline">Stats</span>== The /stats endpoint returns high-level aggregations about the whole knowledge base. There's an "extended" boolean parameter which drives the response format, specifically: When it is set to false, the response is very concise, see the following example:<syntaxhighlight lang="json"> { "item": 137, "agent": { "person": 54, "organization": 16, "family": 16, "meeting": 9 }, "instance": 146, "opus": 120,..."

Show changes

← Older revision		Revision as of 07:51, 3 July 2026
Line 475:		Line 475:
	*[https://sit2-base-svde.atcult.it/meetings.json?q=iat&mode=typeahead&fuzzy=false Meetings typeahead search using '''iat''' (no fuzzy)]		*[https://sit2-base-svde.atcult.it/meetings.json?q=iat&mode=typeahead&fuzzy=false Meetings typeahead search using '''iat''' (no fuzzy)]
	*[https://sit2-base-svde.atcult.it/meetings/3.json Annual J. Lloyd Eaton Conference on Science Fiction and Fantasy Literature]		*[https://sit2-base-svde.atcult.it/meetings/3.json Annual J. Lloyd Eaton Conference on Science Fiction and Fantasy Literature]
	==<span id="Organisation" class="mw-headline">~~Organisation~~</span> ==		==<span id="Organisation" class="mw-headline">Organization</span> ==
	A corporation or group of persons and/or organisations that acts, or may act, as a unit. It is a concrete subclass of Agent and provides a set of attributes, both datatype and object property which interconnect the entity to opuses and other bibliographic entities in the Share-VDE domain model.		A corporation or group of persons and/or organisations that acts, or may act, as a unit. It is a concrete subclass of Agent and provides a set of attributes, both datatype and object property which interconnect the entity to opuses and other bibliographic entities in the Share-VDE domain model.

	<span id=".2Forganisations" class="mw-headline">'''/~~organisations~~'''</span>		<span id=".2Forganisations" class="mw-headline">'''/organizations'''</span>

	Fulltext or Typeahead search across Share-VDE organisations.		Fulltext or Typeahead search across Share-VDE organisations.
Line 542:		Line 542:
	\|0...n		\|0...n
	\|N.A.		\|N.A.
	\|}<span id=".2Forganisations.2F.7Bid.7D" class="mw-headline">'''/~~organisations~~/{id}'''</span>		\|}<span id=".2Forganisations.2F.7Bid.7D" class="mw-headline">'''/organizations/{id}'''</span>

	Returns the organisation associated with the given identifier.		Returns the organisation associated with the given identifier.

	<span id=".2Forganisations.2F.7Bid.7D.2Fopuses" class="mw-headline">'''/~~organisations~~/{id}/opuses'''</span>		<span id=".2Forganisations.2F.7Bid.7D.2Fopuses" class="mw-headline">'''/organizations/{id}/opuses'''</span>

	Returns the opuses of the organisation associated with the given identifier.		Returns the opuses of the organisation associated with the given identifier.