RunStorage.com
Sign up

RunStorage.io

At RunStorage.io we provide fast and reliable APIs and services for developers. To use them, you may sign in to your dashboard with your Google Account.

RunStorage.io Service Description
Backup CI Backup CI securely backs up public GitHub repositories on every commit.
Cloud Storage RunStorage offers custom cloud storage for your needs.
Mail API The Mail API gives you a simple, minimalist endpoint for sending email.
Library CDN A fast and reliable CDN for libraries like jQuery, Bootstrap or Font Awesome.
Markdown API With the Markdown API you can easily compile Markdown to HTML.

If there are any questions regarding these services, you can always feel free to contact us.

# Backup CI v2

Backup CI is a simple GitHub backup service by RunStorage. It provides a Continuous Integration for backing up your public repository on GitHub with every push. All you need to do to back up your repositories, view the current status or download backups is described below.

1) Setting up Backup CI

To get started with Backup CI, you'll need to add our webhook to your repository on GitHub. To do so, please sign in to our web console at https://runstorage.io/. From there copy the so-called Access URL, which should look similar to the one below:

https://backupci.com/v2?key=[YOUR 32 CHAR API KEY]&user_id=[YOUR USER ID]

Once you've copied the Access URL, please open https://github.com and navigate to your repository. From there please select Settings, then Webhooks and after that Add webhook. Retype your password if requested and fill in the form as shown below.

Field What to do?
Payload URL Paste the Access URL beginning with https://backupci.com/.
Content type Select application/json.
Secret Leave empty.
Triggers Answer Which events would you like to trigger this webhook? with Just the push event.

After the webhook has been created, all pushes will be logged in the web console at https://runstorage.io/.

Important Notice: To prevent abuse, we only let you back up once every 15 minutes, but we log all pushes.

2) Current status

To check the current status of your backups, you may either visit our web console at https://runstorage.io/ for a graphical user interface (click the blue repository name for more information) or use our API. The latter is described below.

To list your pushes, please send a GET request to your Access URL. You may append the URL parameter limit to limit the maximal amount of pushes listed.

The result will be a JSON tree with the following structure.

The Backup CI status codes are shown and explained below.

Code Explanation
QUEUED The backup of this tarball has been queued and will be processed soon.
CANCELED This push will not be backed up, since there is a backed up one less than 15 minutes before.
IN_PROGRESS The backup is currently being transferred to our servers.
SUCCESS This backup has been successfully created and is available.
FAILURE There has been an error when processing the backup.

3) Download a backup

You may download backups from our web console at https://runstorage.io/ by clicking the blue repository name and selecting RunStorage.io as backup provider. If you are using this service automatically via its API, backups may be downloaded by requesting the below URL (replace [ID] with runstorage_tarball from your API result). If you would like to list the file's contents instead of downloading please prepend a ~ symbol to your [ID].

https://backupci.com/[ID]

If you run into any issues or have any questions, feel free to contact us.

# Cloud Storage v3

RunStorage offers free cloud storage for personal use. To get started, please contact us with your Security code and Email shown on the runstorage.io dashboard. From there we will provide you with the required documents and login information.

# Mail API v2

The Mail API can be used without authentication for simple straight-forward email sending as shown below.

$ curl -H "Content-Type: application/json" -X POST -d '{"to":"hostmaster@example.com","subject":"Test","body":"Hello world!"}' https://mail.runstorageapis.com/v2
{"success":true}

As you can see above, sending an anonymous email is as simple as POST-ing a JSON with the values to, subject and body to https://mail.runstorageapis.com/v2. The body field supports HTML formatting. In case of an error, the result will also include a value called error which describes why sending failed.

# Library CDN

Our library CDN distributes popular web libraries at the required scale. If you would like to use our CDN for your web projects, please feel free to include resources we host.

The complete list of all libraries provided can be found at https://www.runstorageapis.com/static/index.json.

# Markdown API v1

The Markdown API makes compiling markdown to HTML incredibly easy.

$ curl -H "Content-Type: text/plain" -X POST --data-binary 'Hello **world**!' https://markdown.runstorageapis.com/v1
<p>Hello <strong>world</strong>!</p>

Notice: With curl please use the --data-binary flag instead of --data, since --data kills line feeds.

When requesting the Markdown API at https://markdown.runstorageapis.com/v1 via POST, please be informed that the result is returned with the content-type: text/plain header.

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="https://www.runstorageapis.com/css/bootstrap-markdown.css" rel="stylesheet">
    <title>[Some Title]</title>
  </head>
  <body>
    <br />
    <div class="container">
      <div class="markdown-body">
        [Your HTML result from <code>markdown.runstorageapis.com</code> here.]
      </div>
    </div>
  </body>
</html>

If there are any questions, as always, feel free to contact us.