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()
functionYou are limited to 100
Client.search()
per hour no matter how many itemsmatches
contain. Ex:matches = c.search(query)
.
When using the
matches.download()
functionYou are limited to 100 downloadable items per hour via the
matches.download()
function. For example ifprint(matches)
returnsSearchResults[items=21,volume=36.3MB,jobId=5RNtj0pbopSKws8P2WU7mmNMey8]
thenmatches.download()
will download 21 items so your quota will be 21/100.When using the following functions simultaneously
Client.search()
andmatches.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 aPOST /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
andPOST /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 our contact webpage
via e-mail to our support team (supportATwekeo.eu)