Difference between revisions of "getInstitutes"

From Archives Portal Europe Wiki
Jump to: navigation, search
(→‎Basic Response example)
 
(3 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
This service is a POST-request.
 
This service is a POST-request.
  
−
This institute service delivers a list of institutes that provide their data through the API. Remember that this only contains institutes that have enabled Open Data in the APE Dashboard.
+
This institute-service delivers a list of (archival) institutions that provide their data as Open Data via the API. Remember that this list only contains (archival) institutions that have enabled Open Data in the Archives Portal Europe's Dashboard.
  
 
<div><br/>__TOC__<br/></div>
 
<div><br/>__TOC__<br/></div>
 
= Request parameters =
 
= Request parameters =
−
Two request parameters can be used to get a list of archival institutions that have enabled the API services for their datasets in the Archives Portal Europe's Dashboard.
+
Two request parameters can be used to get a list of (archival) institutions that have enabled the API services for their datasets in the Archives Portal Europe's Dashboard.
  
−
Empty Request example:
+
== Empty Request example ==
−
<pre>
+
<pre style="white-space:-moz-pre-wrap; white-space:-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word;">
 
{
 
{
 
   "count": "5",
 
   "count": "5",
Line 15: Line 15:
 
}
 
}
 
</pre>
 
</pre>
−
+
 
 
== count ==
 
== count ==
 
The resultlist is delivered in chunks of a certain size. Request parameter "count" describes the number of results that are in one chunk. Required.
 
The resultlist is delivered in chunks of a certain size. Request parameter "count" describes the number of results that are in one chunk. Required.
Line 25: Line 25:
 
= Response parameters =
 
= Response parameters =
  
−
The response contains basic information on the institutions that have enabled the API services for their datasets in the Archives Portal Europe's Dashboard.
+
The response contains basic information on the (archival) institutions that have enabled the API services for their datasets in the Archives Portal Europe's Dashboard.
  
−
Empty Response example:
+
== Empty Response example ==
−
<pre>
+
<pre style="white-space:-moz-pre-wrap; white-space:-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word;">
 
{
 
{
 
   "totalResults": 0,
 
   "totalResults": 0,
Line 44: Line 44:
 
</pre>
 
</pre>
  
−
Basic Response example (for count = 5):
+
== Basic Response example ==
−
<pre>
+
For count = 5:
 +
<pre style="white-space:-moz-pre-wrap; white-space:-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word;">
 
{
 
{
−
   "totalResults": 4,
+
   "totalResults": 76,
 
   "institutes": [
 
   "institutes": [
 
     {
 
     {
−
       "name": "Noord-Hollands Archief",
+
       "name": "Štátny archív v Bratislave",
−
       "id": 32125,
+
      "id": 2001,
 +
      "country": "SLOVAKIA",
 +
      "countryId": 32,
 +
      "totalDocs": 2,
 +
      "repositoryCode": "SK-00000002001"
 +
    },
 +
    {
 +
      "name": "Gemeente Leek",
 +
       "id": 2742,
 
       "country": "NETHERLANDS",
 
       "country": "NETHERLANDS",
 
       "countryId": 7,
 
       "countryId": 7,
−
       "totalDocs": 0,
+
       "totalDocs": 21,
−
       "repositoryCode": "NL-HlmNHA"
+
       "repositoryCode": "NL-LekGL"
 
     },
 
     },
 
     {
 
     {
−
       "name": "Historisch Centrum Leeuwarden",
+
       "name": "Gemeente Marum",
−
       "id": 32116,
+
       "id": 2744,
 
       "country": "NETHERLANDS",
 
       "country": "NETHERLANDS",
 
       "countryId": 7,
 
       "countryId": 7,
−
       "totalDocs": 0,
+
       "totalDocs": 15,
−
       "repositoryCode": "NL-LwHCL"
+
       "repositoryCode": "NL-MamGM"
 
     },
 
     },
 
     {
 
     {
−
       "name": "Regionaal Archief Tilburg",
+
       "name": "Gemeente Stadskanaal",
−
       "id": 32018,
+
       "id": 2749,
 
       "country": "NETHERLANDS",
 
       "country": "NETHERLANDS",
 
       "countryId": 7,
 
       "countryId": 7,
−
       "totalDocs": 0,
+
       "totalDocs": 19,
−
       "repositoryCode": "NL-TbRAT"
+
       "repositoryCode": "NL-SknGS"
 
     },
 
     },
 
     {
 
     {
−
       "name": "Nationaal Archief",
+
       "name": "Provincie Groningen",
−
       "id": 32171,
+
       "id": 2755,
 
       "country": "NETHERLANDS",
 
       "country": "NETHERLANDS",
 
       "countryId": 7,
 
       "countryId": 7,
−
       "totalDocs": 15,
+
       "totalDocs": 0,
−
       "repositoryCode": "NL-HaNA"
+
       "repositoryCode": "NL-GnPG"
 
     }
 
     }
 
   ]
 
   ]
Line 94: Line 103:
 
{| class="wikitable"
 
{| class="wikitable"
 
| name  
 
| name  
−
| Name of the archival institution  
+
| Name of the (archival) institution  
 
|-
 
|-
 
| id  
 
| id  
−
| Internal APE identifier of the result, ie the internal APE identifier of the archival institution
+
| Internal APE identifier of the result, ie the internal APE identifier of the (archival) institution
 
|-
 
|-
 
| country  
 
| country  
−
| Name of the country where the repository is. In English
+
| Name of the country where the repository is, in English
 
|-
 
|-
 
| countryId
 
| countryId
Line 106: Line 115:
 
|-
 
|-
 
| totalDocs
 
| totalDocs
−
| Total amount of documents of the archival institution available via the API services
+
| Total amount of documents of the (archival) institution available via the API services
 
|-
 
|-
 
| repositoryCode  
 
| repositoryCode  
−
| Code of the repository holding the fonds. Preferably, but not necessarily [https://en.wikipedia.org/wiki/International_Standard_Identifier_for_Libraries_and_Related_Organizations ISIL]
+
| Code of the repository holding the fonds; preferably, but not necessarily [https://en.wikipedia.org/wiki/International_Standard_Identifier_for_Libraries_and_Related_Organizations ISIL]
 
|}
 
|}
  
  
 
[[Category:Technical_documentation]]
 
[[Category:Technical_documentation]]

Latest revision as of 12:38, 10 January 2018

Request url: https://api.archivesportaleurope.net/services/institute/getInstitutes/. This service is a POST-request.

This institute-service delivers a list of (archival) institutions that provide their data as Open Data via the API. Remember that this list only contains (archival) institutions that have enabled Open Data in the Archives Portal Europe's Dashboard.



Request parameters

Two request parameters can be used to get a list of (archival) institutions that have enabled the API services for their datasets in the Archives Portal Europe's Dashboard.

Empty Request example

{
  "count": "5",
  "startIndex": 0
}

count

The resultlist is delivered in chunks of a certain size. Request parameter "count" describes the number of results that are in one chunk. Required.

startIndex

Request parameter "startIndex" enables you to select the results that you want to have. Counting starts at zero. If "count" = 5, the second chunk starts with startIndex 5, the following at startIndex 10, etc. Required.

Response parameters

The response contains basic information on the (archival) institutions that have enabled the API services for their datasets in the Archives Portal Europe's Dashboard.

Empty Response example

{
  "totalResults": 0,
  "institutes": [
    {
      "name": "string",
      "id": 0,
      "country": "string",
      "countryId": 0,
      "totalDocs": 0,
      "repositoryCode": "string"
    }
  ]
}

Basic Response example

For count = 5: 

{
  "totalResults": 76,
  "institutes": [
    {
      "name": "Štátny archív v Bratislave",
      "id": 2001,
      "country": "SLOVAKIA",
      "countryId": 32,
      "totalDocs": 2,
      "repositoryCode": "SK-00000002001"
    },
    {
      "name": "Gemeente Leek",
      "id": 2742,
      "country": "NETHERLANDS",
      "countryId": 7,
      "totalDocs": 21,
      "repositoryCode": "NL-LekGL"
    },
    {
      "name": "Gemeente Marum",
      "id": 2744,
      "country": "NETHERLANDS",
      "countryId": 7,
      "totalDocs": 15,
      "repositoryCode": "NL-MamGM"
    },
    {
      "name": "Gemeente Stadskanaal",
      "id": 2749,
      "country": "NETHERLANDS",
      "countryId": 7,
      "totalDocs": 19,
      "repositoryCode": "NL-SknGS"
    },
    {
      "name": "Provincie Groningen",
      "id": 2755,
      "country": "NETHERLANDS",
      "countryId": 7,
      "totalDocs": 0,
      "repositoryCode": "NL-GnPG"
    }
  ]
}

totalResults

The response parameter "totalResults" gives the number of results.

institutes

Enumeration of the results.

name Name of the (archival) institution
id Internal APE identifier of the result, ie the internal APE identifier of the (archival) institution
country Name of the country where the repository is, in English
countryId Internal APE identifier of the country
totalDocs Total amount of documents of the (archival) institution available via the API services
repositoryCode Code of the repository holding the fonds; preferably, but not necessarily ISIL
Retrieved from "http://wiki-deprecated.archivesportaleurope.net/index.php?title=getInstitutes&oldid=1795"