Custom Connector
Open Notify Connector
Global
The Open Notify Connector provides a RESTful interface to real-time space data — the current geographic location of the International Space Station (ISS) and the list of astronauts currently in space. It offers simple, stable, no-authentication endpoints, ideal for space-related educational tools, tracking dashboards, and awareness apps.
Overview
Integration Overview
The Open Notify Connector offers the following integration points to retrieve live space-related data.
- getCurrentISSLocation. Fetch the current latitude and longitude of the International Space Station.
- getPeopleInSpace. Retrieve the list of astronauts currently in space and their spacecraft.
Documentation
Detailed Integration Documentation
Get Current ISS Location
| Operation | getCurrentISSLocation |
|---|---|
| Method | GET |
| Purpose | Retrieves the current geographical position of the International Space Station. |
| Parameters | None required. |
| Output | Successful: JSON with timestamp, latitude, and longitude. Failure: error object on internal failure or network issue. |
| Workflow example | Trigger a GET request, parse latitude/longitude, and display the coordinates on a map or space-tracking visualization. |
Get People in Space
| Operation | getPeopleInSpace |
|---|---|
| Method | GET |
| Purpose | Retrieves a live list of astronauts currently in orbit. |
| Parameters | None required. |
| Output | Successful: JSON with the total number of people in space and an array of names and spacecraft. Failure: error message if the service is temporarily unavailable. |
| Workflow example | Perform a GET request, extract astronauts and spacecraft, and present in a real-time dashboard. |
Example Workflow: Real-Time Space Dashboard
| Track ISS | Use getCurrentISSLocation at regular intervals (every 5–10 seconds) to update a live map marker. |
|---|---|
| Astronauts in orbit | Call getPeopleInSpace and show names and spacecraft in a UI panel. |
| Error handling | Gracefully handle timeouts or missing data; retry with exponential backoff on transient failures. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.