Limitation of Requests and Orders

Let's see in detail what the limitation is about

Alexandre avatar
Written by Alexandre
Updated over a week ago

Context


There is a limitation that will limit the number of requests but also the number of orders made by user on an interval of one hour. This limitation applies to the HDA API Python package and to the HDA REST API via cURL or Wget.

This article aims to detail how this limitation is done and it is divided in 2 parts depending if you use the HDA API Python package or the HDA REST API via cURL or Wget.

Use of the HDA API Python package


If you use HDA API Python package a limitation is made:

  • When using the Client.search() function

    You are limited to 100 Client.search() per hour no matter how many items matches contain. Ex: matches = c.search(query).

  • When using the matches.download() function

    You are limited to 100 downloadable items per hour via the matches.download() function. For example if print(matches) returns SearchResults[items=21,volume=36.3MB,jobId=5RNtj0pbopSKws8P2WU7mmNMey8] then matches.download() will download 21 items so your quota will be 21/100.

  • When using the following functions simultaneously Client.search() and matches.download(): you can only have 20 such functions running simultaneously.

Note that you get back each of your actions 1 hour after you have done them. Let's take the example of downloading an item at 2pm and another one at 2:30pm, then at 2:30pm your quota is at 2/100, at 3pm your quota is at 1/100 and at 3:30pm your quota is at 0/100.

πŸ’‘WEkEO Pro Tip: re-running the matches.download() function without changing matches does not count in the quota again. In the opposite, the function Client.search() will count in the quota again.

In case you want to download more than 100 items then you can proceed as in this example: let's say you have 149 items to download, you run matches[0:100].download() to download the first 100, then 1 hour later you run matches[100:150].download() to download the next 49 items.

πŸ“Œ Note: if you want to increase your quota you can contact the WEkEO support.

Use of the HDA REST API via cURL or Wget


If you use the HDA REST API a limitation is made:

  • When using the operation POST /datarequest

    You are limited to 100 POST /datarequest operations per hour. Knowing that a POST /datarequest can contain several downloadable items. Here is an example with cURL command.

  • When using the operation POST /dataorder

    You are limited to 100 downloadable items per hour via the POST /dataorder operation. Here is an exemple with cURL command .

  • When using POST /datarequest and POST /dataorder operations simultaneously: you can only have 20 such operations running simultaneously.

Note that you get back each of your actions 1h after you have done them. Let's take the example of ordering an item at 2pm and another one at 2:30pm, then at 2:30pm your quota is at 2/100, at 3pm your quota is at 1/100 and at 3:30pm your quota is at 0/100.

πŸ’‘WEkEO Pro Tip: re-running a POST /dataorder operation already performed with the same JobId and the same uri does not count in the quota again. In the opposite, the function POST /datarequest will count in the quota again.

πŸ“ŒNote: if you want to increase your quota you can contact the WEkEO support.

What's next?


These articles might be of interest for you:

We are user-driven and we implement users' suggestions, so feel free to contact us:

  • through a chat session available in the bottom right corner of the page

  • via e-mail to our support team (supportATwekeo.eu)

Did this answer your question?