Entitiy Search API HTTP status code

Catherine Wong
Catherine Wong
in Open PermID

I am using the Entitiy Search API. What HTTP status code is returned if I issue a request but the daily limit of my access token has been reached?

Tagged:

Best Answer

  • Steven McCoy
    Steven McCoy
    Answer ✓

    HTTP/429 is used for both exceeding ones permitted request rate and for exceeding the daily permitted request count.

    HTTP/503 is also noteworthy here for when the server has reached capacity and is unable to fulfil the request.

    One would have to parse the response text to determine which limit is breached.

    The OpenCalais User Guide §1.3 states the account limits start at 0.5-1 per second, 5,000 per day, and 100KB maximum article size.

Answers

  • andy
    andy

    Thank for the reply. What is the permitted request rate in this case?

  • andy
    andy

    Thank for the reply. What is the permitted request rate in this case?

  • Steven McCoy
    Steven McCoy

    @andy it would have been provided alongside your credentials and daily quota. Note that requests exceeding the request rate will count against the daily quota and thus the client should be designed to throttle itself.

  • andy
    andy

    I see that I must wait 750 milliseconds in between each request now. I was not told explicitly what my daily quota is, but having read the documentation is it 5000 per day?

  • Steven McCoy
    Steven McCoy

    @andy the figure 750ms is provided as an example period, it is generally recommended to backoff more than the absolute minimum in case of severe sever side overload by premium users.

Categories