Peek Inside
Pings allow you to monitor your infrastructure (webservers, databases, mission critical servers etc.) for availability and performance.
View all of your Uptime Pings
You can view all your Pings on the one screen along with the Ping's Name, Hostname, Port, Last Completed Date and if it appears on your Public Status Page.
Adding a new Uptime Ping
Click on 'Add a ping' to get started. Input a Name, Hostname and Port. Pings support hostnames, different port numbers and even IP addresses if need to monitor services.
View your Uptime Ping Logs
Click on 'View' to view your Uptime Ping Logs. You can see your availability over time and optimize your infrastructure for better load times - delivering the best Customer Experience.
Basic Usage
Setup your first Ping
This tutorial will allow you to ping Google and get notified when their website is unavailble.
- Click the 'Add a ping' button.
- Input google.com as the hostname and 443 as the port number and save.
- SaaS Ninja will ping the hostname and notify you if it becomes unavailable.
API Overview
Authentication
You'll need to authenticate using your API Key.
There are two ways to authenticate:
Request Headers:
$ curl -H "X-Api-Id: <API_KEY_ID>" -H "X-Api-Secret: <API_SECRET>" 'https://snja.io'
URL Parameters:
$ curl 'https://snja.io/foo?_id=<API_KEY_ID>&_secret=<API_SECRET>'
API Keys
API Keys can be created and managed in the API Keys section.
- Go to the API Keys section.
- Click on the button 'Generate API Key'.
- A new key will be genereated for use with the API.
Rate Limits
API Keys are rate limited to ensure fair delivery of services. You can view the current Rate Limit and Remaining Requests in the returned Response Headers from the API. Below is a description of the Response Headers.
| Header | Description |
|---|---|
| X-RateLimit-Limit | The maximum number of requests per time window. |
| X-RateLimit-Remaining | The number of requests remaining before reset. |
| X-RateLimit-Reset | The time at which the current rate limit window resets in UTC Epoch seconds. |
Error Codes
The following HTTP response codes are used.
| Code | Message | Description |
|---|---|---|
| 200 | OK | The request has succeeded. |
| 400 | Bad Request | The request could not be understood by the server due to malformed syntax. |
| 401 | Unauthorised | This indicates that you have not passed a valid API key, the key has expired, or the Authorization header is not formatted correctly. |
| 404 | Not Found | The server has not found anything matching the Request-URI. |
| 405 | Method Not Allowed | This indicates that the request method is known by the server but has been disabled and cannot be used. |
| 429 | Too Many Requests | We have recieved too many requests from your API Key in a given amount of time. Wait a while and try again. |
More Products
Device Shots
Easily mock-up your app screenshots onto different devices for marketing
Ring the Bell
Login on a TV or Pi and ring an audible bell every time the team makes a sale
NPS Feedback
Your Net Promoter Score measures brand loyalty and forecasts business growth
Uptime Pings
Get notified instantly when your website is down and not responding to requests
Cron Monitoring
Get notified when your cron jobs fail or benchmark their performance
Status Page
Keep your customers informed during scheduled or unplanned outages
GEOIP to Country
Lookup Country, Language & Currency Information from an IP address
DNS Watcher
Track DNS changes on your domains & get notified of expiring certificates
Competitor Monitor
Monitor your competitors' websites and get notified when they change
Builder API
Cross-platform Hybrid App build service for Cordova, React Native & Flutter
Ninjalytics
Generate swimlane charts of your customer's journey through your product
Request Bins
Capture & inspect HTTP requests. Replay the request to your local machine