{"source":"nve","operation":"get_hydro_percentiles","description":"Get day-of-year percentile bands (the seasonal \"normal\") for a station's\nparameter, computed by NVE over the station's full record. Use them as the\nreference band to judge whether an observed value is high or low for the\ntime of year, e.g. is inflow above or below normal right now.","parameters":[{"name":"station_id","schema":{"type":"string"},"required":true,"default":null,"description":"NVE station id, e.g. \"1.200.0\" (from find_hydro_stations)."},{"name":"parameter","schema":{"type":"integer"},"required":true,"default":null,"description":"Numeric parameter id, e.g. 1001=discharge, 1000=water level."},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"display_type":"integer","required":false,"default":25,"description":"Maximum list items returned by the gateway (default 25, maximum 100)."},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page."}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/nve/get_hydro_percentiles?station_id={station_id}&parameter={parameter}&limit=25&offset=0","schema_scope":"#/data in the successful operation envelope","response_schema":{"type":"object","properties":{"station_id":{"type":["string","null"]},"parameter":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"percentiles":{"type":"array","items":{"type":"object","properties":{"date_mmdd":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"mean":{"type":"number"},"p10":{"type":"number"},"p25":{"type":"number"},"p50":{"type":"number"},"p75":{"type":"number"},"p90":{"type":"number"}},"additionalProperties":false}},"note":{"type":"string"}},"additionalProperties":false},"response_schema_status":{"status":"incomplete","codegen_safe":false,"description":"Not suitable for typed model generation: the container shape and field names are useful, but unresolved values accept any JSON value."},"entity_projection":{"status":"projected","entity_types":["hydrology_station"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"error_contract":{"scope":"top-level HTTP error response; never part of a success payload","schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}},"additionalProperties":false,"required":["code","message","retryable"]},"suggestion":{"type":"string"},"_meta":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time"},"language":{"type":"string","const":"en"},"content_languages":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object"}}},"required":["retrieved_at","language","content_languages","sources"]},"_links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"api_index":{"type":"string","format":"uri"}},"required":["self","api_index"],"additionalProperties":false}},"additionalProperties":false,"required":["error","suggestion","_meta","_links"]},"statuses":{"400":{"codes":["MISSING_PARAMETER","INVALID_PARAMETER","INVALID_REQUEST"],"retryable":false},"404":{"codes":["SOURCE_NOT_FOUND","OPERATION_NOT_FOUND","ENTITY_NOT_FOUND"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"502":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":true}}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/nve/get_hydro_percentiles/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/nve/get_hydro_percentiles","source":"https://allemannsdata.com/wiki/api/v1/kilder/nve"},"output_fields":["station_id","parameter","percentiles","percentiles[].date_mmdd","percentiles[].mean","percentiles[].p10","percentiles[].p25","percentiles[].p50","percentiles[].p75","percentiles[].p90","note"],"output_fields_truncated":false,"canonical_field_aliases":{}}