# Endpoints (/docs/endpoints) ## All Data [#all-data] The **All Data** endpoint returns a random image and fact for a specific celestial object. ### Endpoint [#endpoint] **GET** `/all` #### Base URL [#base-url] [https://api.bootprint.space/all](https://api.bootprint.space/all) ### Example Request [#example-request] ```bash curl -X GET "https://api.bootprint.space/all/mars" ``` ### Parameters [#parameters] | Parameter | Type | Description | Required | | --------- | ------ | ----------------------------------------------------------- | -------- | | object | string | The celestial object name (e.g., `mars`, `jupiter`, `moon`) | Yes | ### Example Response [#example-response] ```json { "object": "mars", "image": "https://cdn.bootprint.space/mars/1.png", "image_id": "c3a1f9a7-29e4-4f91-9f1c-7d2e987f8d7d", "fact": "Mars is home to the tallest mountain in the solar system.", "fact_id": "e8b4b024-52b7-4d1c-b64b-329d6c0f3f0e" } ``` ## Random Image [#random-image] The **Random Image** endpoint returns only a random image URL for a specific celestial object. ### Endpoint [#endpoint-1] **GET** `/img` #### Base URL [#base-url-1] [https://api.bootprint.space/img](https://api.bootprint.space/img) ### Example Request [#example-request-1] ```bash curl -X GET "https://api.bootprint.space/img/mars" ``` ### Example Response [#example-response-1] ```json { "object": "mars", "image": "https://cdn.bootprint.space/mars/1.png", "image_id": "c3a1f9a7-29e4-4f91-9f1c-7d2e987f8d7d" } ``` ## Random Fact [#random-fact] The **Random Fact** endpoint returns only a random fact for a specific celestial object. ### Endpoint [#endpoint-2] **GET** `/fact` #### Base URL [#base-url-2] [https://api.bootprint.space/fact](https://api.bootprint.space/fact) ### Example Request [#example-request-2] ```bash curl -X GET "https://api.bootprint.space/fact/mars" ``` ### Example Response [#example-response-2] ```json { "object": "mars", "fact": "Mars is home to the tallest mountain in the solar system.", "fact_id": "e8b4b024-52b7-4d1c-b64b-329d6c0f3f0e" } ``` ## Error Responses [#error-responses] If the request is invalid or the object is not supported, the API will return an error. ```json { "error": "Invalid object name. Please provide a valid celestial object." } ``` ## Rate Limiting [#rate-limiting] The Bootprint API currently does not impose strict rate limits. Please be mindful of excessive requests to ensure fair usage for all users. # FAQ (/docs/faq) Everything you need to know about Bootprint, from the name to usage and support. ### Why the name *Bootprint*? [#why-the-name-bootprint] The name *Bootprint* is a tribute to humanity's first steps on the Moon — a symbol of exploration and discovery. Just like those iconic bootprints, Bootprint aims to leave its mark by bringing the wonders of space to everyone. ### Is the API free to use? [#is-the-api-free-to-use] Yes, Bootprint is completely free to use. ### Do I need an API key? [#do-i-need-an-api-key] No API key is required — simply call the API endpoints and start exploring. ### What are the rate limits? [#what-are-the-rate-limits] Currently, there are **no rate limits** on the API. However, this may change in the future to ensure fair usage and service stability. ### How can I get started? [#how-can-i-get-started] Visit the [Endpoints](/docs/endpoints) page to learn how to make your first API call. ### How can I support the project? [#how-can-i-support-the-project] Sharing the API, building cool projects with it, and spreading the word is the best way to support Bootprint. # Hubble (/docs/hubble) Hubble is the official Bootprint Discord bot. Add it to your server to explore the universe with slash commands. ## Add to Discord [#add-to-discord] [Add Hubble to your server](https://discord.com/oauth2/authorize?client_id=1346600888919261194\&permissions=0\&scope=bot+applications.commands\&redirect_uri=https://bootprint.space/hubble/success\&response_type=code) ## Commands [#commands] | Command | Description | | ---------- | ------------------------------------ | | `/earth` | Random image and fact about Earth | | `/moon` | Random image and fact about the Moon | | `/mars` | Random image and fact about Mars | | `/jupiter` | Random image and fact about Jupiter | | `/saturn` | Random image and fact about Saturn | | `/mercury` | Random image and fact about Mercury | | `/venus` | Random image and fact about Venus | | `/uranus` | Random image and fact about Uranus | | `/sun` | Random image and fact about the Sun | | `/help` | List all commands | | `/info` | About Hubble | ## Support [#support] Join our [Discord server](https://discord.gg/nxR5YN6R9q) for help and updates. # Introduction (/docs) ## Sponsor [#sponsor] By sponsoring Bootprint, you'll support us in enhancing our services, expanding our reach, and enabling everyone to learn about space. You can sponsor us [here](https://github.com/sponsors/bootprint-space/). ## Support [#support] If you have any questions or feedback, reach out via [email](mailto:support@bootprint.space) or join [our Discord server](https://discord.gg/nxR5YN6R9q). # Packages (/docs/packages) Official packages for integrating Bootprint into your projects. | Package | Language | Source | | ---------------------------------------------------------- | -------------------- | --------------------------------------------------------- | | [bootprint-js](https://www.npmjs.com/package/bootprint-js) | JavaScript / Node.js | [GitHub](https://github.com/bootprint-space/bootprint-js) | More packages are coming soon. Want to build one? Check out the [endpoints](/docs/endpoints) and open a PR on [GitHub](https://github.com/bootprint-space). # Usage (/docs/usage) The Bootprint API is free to use and requires no authentication. Simply make a GET request to the desired endpoint. The base URL for all requests is: [https://api.bootprint.space](https://api.bootprint.space) See the [Endpoints](/docs/endpoints) page for a full list of available endpoints.