Skip to content

Latest commit

 

History

History
145 lines (131 loc) · 6.03 KB

README.md

File metadata and controls

145 lines (131 loc) · 6.03 KB
Raw

SpaceX REST API

Open Source REST API for rocket, core, capsule, pad, and launch data

Docs

See the Wiki for full API Documentation

Usage

Example Response

GET https://api.spacexdata.com/v2/launches/latest
{
  "flight_number": 64,
  "mission_name": "CRS-15",
  "launch_year": "2018",
  "launch_date_unix": 1530265320,
  "launch_date_utc": "2018-06-29T09:42:00.000Z",
  "launch_date_local": "2018-06-29T05:42:00-04:00",
  "rocket": {
    "rocket_id": "falcon9",
    "rocket_name": "Falcon 9",
    "rocket_type": "FT",
    "first_stage": {
      "cores": [
        {
          "core_serial": "B1045",
          "flight": 2,
          "block": 4,
          "reused": true,
          "land_success": null,
          "landing_type": null,
          "landing_vehicle": null
        }
      ]
    },
    "second_stage": {
      "block": 4,
      "payloads": [
        {
          "payload_id": "SpaceX CRS-15",
          "cap_serial": "C111",
          "reused": true,
          "customers": [
            "NASA (CRS)"
          ],
          "payload_type": "Dragon 1.1",
          "payload_mass_kg": 2410,
          "payload_mass_lbs": 5313,
          "orbit": "ISS",
          "orbit_params": {
            "reference_system": "geocentric",
            "regime": "low-earth",
            "longitude": null,
            "semi_major_axis_km": null,
            "eccentricity": null,
            "periapsis_km": null,
            "apoapsis_km": null,
            "inclination_deg": 51.6,
            "period_min": null,
            "lifespan_years": null
          },
          "mass_returned_kg": null,
          "mass_returned_lbs": null,
          "flight_time_sec": null,
          "cargo_manifest": null
        }
      ]
    }
  },
  "telemetry": {
    "flight_club": "https://www.flightclub.io/results/?code=CR15"
  },
  "reuse": {
    "core": true,
    "side_core1": false,
    "side_core2": false,
    "fairings": false,
    "capsule": false
  },
  "launch_site": {
    "site_id": "ccafs_slc_40",
    "site_name": "CCAFS SLC 40",
    "site_name_long": "Cape Canaveral Air Force Station Space Launch Complex 40"
  },
  "launch_success": true,
  "links": {
    "mission_patch": "https://images2.imgbox.com/43/35/0QW7yRsB_o.png",
    "mission_patch_small": "https://images2.imgbox.com/11/ec/xng5hAXN_o.png",
    "reddit_campaign": "https://www.reddit.com/r/spacex/comments/8pua1m/crs15_launch_campaign_thread/",
    "reddit_launch": "https://www.reddit.com/r/spacex/comments/8ugo3l/rspacex_crs15_official_launch_discussion_updates",
    "reddit_recovery": null,
    "reddit_media": "https://www.reddit.com/r/spacex/comments/8ujcwo/rspacex_crs15_media_thread_videos_images_gifs/",
    "presskit": "http://www.spacex.com/sites/spacex/files/crs15presskit.pdf",
    "article_link": "https://spaceflightnow.com/2018/06/29/spacex-launches-ai-enabled-robot-companion-vegetation-monitor-to-space-station/",
    "wikipedia": "https://en.wikipedia.org/wiki/SpaceX_CRS-15",
    "video_link": "https://www.youtube.com/watch?v=ycMagB1s8XM"
  },
  "details": "Payload included MISSE-FF 2, ECOSTRESS, and a Latching End Effector. The refurbished booster featured a record 2.5 months period turnaround from its original launch of the TESS satellite — the fastest previous was 4.5 months. This was the last commercial flight of a Block 4 booster, which was expended into the Atlantic without landing legs and grid fins."
}

Community made API Clients / Wrappers

Lang Link
.NET Tearth/Oddity
Node.js Thomas-Smyth/SpaceX-API-Wrapper
Powershell lazywinadmin/SpaceX

Contributions

See the Contribution guide for detailed steps

Local Development

Local development info can be found here

Technical Details

  • API is using Node.js with the Koa framework
  • All data stored in a MongoDB Atlas 3 node replica set cluster
  • Latest database mongodump available here
  • Uses Redis on RedisCloud for route caching
  • Uses Jest and Supertest for tests
  • Uses Travis CI for continuous integration/delivery
  • API deployed on a Heroku pipeline with pull request, staging and production servers

FAQ's

  • If you have any questions or corrections, please open an issue and we'll get it merged ASAP
  • All data and photos are property of Space Exploration Technologies Corporation (SpaceX)
  • I am not affiliated with SpaceX in any way, shape, form, or fashion. Just a fun side project for me
  • For any other questions or concerns, just shoot me an email

License

FOSSA Status