FAQ - WeatherSentry® API

Version 8

    What data types are in which package?

    "Basic Datatypes" =  HourlyLatestObservation, DailyForecast, DailyNormal, DailyObservation,  LatestTAFF, LatestMETAR and LatestNOTAM

    "Professional Datatypes" =   HourlyForecast,HourlyGriddedPrecipitation, HourlyObservation,

    "Interpolated Datatypes" =  DailyInterpolatedObservation, DailyInterpolatedForecast, DailyInterpolatedNormal

    "Historical Datatypes" = "DailyObservationExtended"

     

    What is an API request?

    An API requests is one programmatic request to a service. Examples of single requests are:

    • A call for a station or location for the last 24 hour of observation data
    • A  call for a station or location for 14 days of hourly forecasts
    • A call for the past 60 days of hourly observation data
    • A query for radar over North America
    • A query for all lightning strikes over Rhode Island

    Each count as a single request. The time periods or the amount of data do not increment the request count.

     

    Can I call for multiple stations in a single request? How?

    Multi-station requests are currently possible, but scheduled to be discontinued in a future release. The response time is typically slower than the collective total response time of making the requests individually. Note that multi-station requests will also count against rate limits (a multi-station request of 4 stations increments the request count by 4, instead of 1).

     

    For best performance and continuity of service, single station requests are strongly recommended. However, if you still wish to pursue this approach you can ask for up to 20 stations at a time by adding ‘&stationID=XXXX&stationID=XXXX’ to the request string

    How do I know how many API requests I have made?

    Each call returns the number of calls made per day, or per minute in the response header  :X-RateLimit-Remaining-Day, X-RateLimit-Remaining-Minute, respectively

     

    How many active connections can I have open simultaneously?

    The active connection count is defaulted to be a ratio of calls-per-minute level, as follows:

     

    Per-Minute Request Limit

    Concurrent Connection Limit

    150050
    125030
    100025
    50010
    1005

     

    There can be situations where concurrency will to be moved up or down, depending on the type of data being retrieved. If you have questions or concerns contact us.

    Multi-station requests are currently possible, but scheduled to be discontinued in a future release. The response time is typically slower than making the requests individually, and is not optimized well, if at all on the backend.

     

    For best performance and continuity of service, single station requests are recommended. However, if you still wish to pursue this approach you can ask for up to 20 stations at a time by adding ‘&stationID=XXXX&stationID=XXXX’ to the request string