Live Request
Enter a URL below to have it checked against from this server.
IsUp API
This is a simple service to check if a page is responsive. Useful in situations where you need to verify a resource is reachable from outside a specific networking context.
The API
The way this API checks if a URL is reachable, is it sends a HEAD request to the remote server for the given URL. The request will come from a user agent of ZiviZIsUpAPI/1.0 (+http://www.ziviz.net/)
How to use
This API is dead simple to use. Just send a GET request to https://ziviz.net/tools/isup/isupapi.php with a testurl variable. In CURL this would look like curl https://ziviz.net/tools/isup/isupapi.php?testurl=https://google.com
Return Object
The return result will either be an HTTP response code error with the body being a description of the error. This will be for errors thrown from the service itself. Or it will be a success code, with the body being a JSON representation of the results. The return JSON object should contain 5 properties
| Name | Description |
|---|---|
| url | The URL that was requested |
| result | The returned result from the remote URL. Either "Failed to connect", if it failed to connect. Or "HTTP STATUS <status code as number>" for most normal server responses, or "HTTP STATUS Error: *" for other errors not covered by HTTP codes. (Such as TLS validation errors) |
| cacheexpire | When this result will be removed from cache |
| cachetime | When this result was added to cache |
| fromcache | If this result was returned from the cache, this will be true. If this was freshly checked, it will be false. |
Limits
All requests are cached for 10 minutes and further requests for the same URL will be returned from cache. Further, there is rate limiting enabled against remote hostnames and IPs. Requests that are not cached and resolve to a host or IP that was already queried in the last 5 seconds will result in a 429 status code. This is all to help prevent abuse.