Project

General

Profile

« Previous | Next » 

Revision 51726

Added by Alessia Bardi about 6 years ago

Added section on terms of services and SLA in the specific API pages

View differences:

api.html
155 155 
                    </div>
156 156 

  		




  157
  157
  
    
                  <p>


  		




  158
  
  
    
                    The OpenAIRE HTTP API allows developers to access the metadata information space of OpenAIRE+ by performing queries over publications, datasets, and projects.


  		




  
  158
  
    
                    The OpenAIRE HTTP API allows developers to access the metadata information space of OpenAIRE by performing queries over publications, datasets, and projects.


  		




  159
  159
  
    
                    The API is intended for metadata discovery and exploration only, that is it does not give direct access to publication files and it does not provide access to


  		




  160
  160
  
    
                    the whole information space: the number of total results returned by one query is limited to 10,000. For accessing the whole information space, developers are


  		




  161
  161
  
    
                    encouraged to use the <a href="http://api.openaire.eu/#cha_oai_pmh" target="_blank">OAI-PMH</a>.<br>


  		




  162
  162
  
    
                  </p>


  		




  163
  
  
    
                    <p>


  		




  164
  
  
    
                        API rate limits:


  		




  
  163
  
    

  		




  
  164
  
    
                    <div>


  		




  
  165
  
    
                        <h4>TERMS OF USE AND SLA</h4>


  		




  
  166
  
    
                        <p><strong>OpenAIRE HTTP API</strong>: the APIs are free-to-use (no sign-up needed) by any third-party service. Note that:</p>


  		




  165
  167
  
    
                        <ul>


  		




  166
  
  
    
                            <li>no more then 37 concurrent request in total (max 30 per single IP)</li>


  		




  167
  
  
    
                            <li>no more than 15 requests/second (in total, not per IP. If this limit is reached, requests will be delayed).</li>


  		




  
  168
  
    
                            <li>The HTTP API limits each query to 10,000 paged results; for unlimited access to the APIs please contact <a href="mailto:paolo.manghi@isti.cnr.it">the service administrators</a>.


  		




  
  169
  
    
                            </li>


  		




  
  170
  
    
                            <li>Since 2015 an <a href="https://zenodo.org/record/51077#.WsdCFdNubOR">RDF dump of the LOD is made available in Zenodo.org</a></li>


  		




  168
  171
  
    
                        </ul>


  		




  169
  
  
    
                    </p>


  		




  
  172
  
    
                        <p><strong> Metadata license is CC-BY</strong>: the metadata records retuned by the service can be freely re-used by commercial and non-commercial partners under CC-BY license, hence as long as OpenAIRE is acknowledged as content provider.


  		




  
  173
  
    
                        </p>


  		




  
  174
  
    
                        <p><strong>Quality of Service</strong>: all API services are running in production 24/7 within the OpenAIRE infrastructure premises deployed at the <a href="http://icm.edu.pl/en/centre-of-technology/">data center</a> facilities of the <a href=http://icm.edu.pl/en/">Interdisciplinary Centre for Mathematical and Computational Modelling</a> (ICM).


  		




  
  175
  
    
                        </p>


  		




  
  176
  
    
                        <p><strong>APIs rate limits</strong>


  		




  
  177
  
    
                        <ul>


  		




  
  178
  
    
                            <li>no more than 30 concurrent connections from single IP to any APIs</li>


  		




  
  179
  
    
                            <li>no more than 67 concurrent requests in total</li>


  		




  
  180
  
    
                            <li>no more then 37 concurrent request in total (max 30 per single IP) to the HTTP API for selective access</li>


  		




  
  181
  
    
                            <li>no more than 15 requests/second to the HTTP API for selective access (in total, not per IP. If this limit is reached, requests will be delayed).</li>


  		




  
  182
  
    
                        </ul>


  		




  
  183
  
    
                        </p>


  		




  
  184
  
    
                    </div>


  		




  
  185
  
    

  		




  
  186
  
    

  		




  
  187
  
    
                    <h2 id="common">Common Parameters</h2>


  		




  
  188
  
    

  		




  170
  189
  
    
                    <p> Parameters included in this section can always be specified, regardless the type of <strong>entities</strong> (metadata about <strong>publications</strong>,


  		




  171
  
  
    
                      <strong>datasets</strong>, or <strong>projects</strong>) you want to retrieve. <br>


  		




  
  190
  
    
                        <strong>datasets</strong>, or <strong>projects</strong>) you want to retrieve. <br>


  		




  172
  191
  
    
                        To query for publications metadata: <strong>http://api.openaire.eu/search/publications</strong> <br>


  		




  173
  192
  
    
                        To query for datasets metadata: <strong>http://api.openaire.eu/search/datasets</strong> <br>


  		




  174
  193
  
    
                        To query for projects metadata: <strong>http://api.openaire.eu/search/projects</strong> <br>


  		




  175
  194
  
    
                    </p>


  		




  176
  195
  
    

  		




  177
  
  
    
                    <h2 id="common">Common Parameters</h2>


  		




  178
  
  
    

  		




  179
  196
  
    
                    <table class="uk-table uk-table-striped uk-table-hover uk-table-small">


  		




  180
  197
  
    
                      <thead>


  		




  181
  198
  
    
                          <tr>


  		












Also available in:  Unified diff