NudgeHost

Finish an upload that create_upload_url started. Call it once the bytes have been PUT to the upload URL. The link does not serve anything until this succeeds. An HTML page is served at its own nudgehost.site address, as create_upload_url predicted. A ZIP that holds a file named index.html and is 100MB or smaller becomes a hosted site at its own address, so the URL this returns is the final one and can differ from the address create_upload_url predicted. A ZIP without an index.html, or over 100MB, stays a download. Report the URL this returns. It takes the id create_upload_url gave you and nothing else.

Start an upload for a file this server does not hold, and get back a URL to send the bytes to. Two steps are needed: PUT the bytes to the returned URL with exactly the headers it gives you, then call complete_upload with the id it returns. The link does not work until both have happened. The upload URL is valid for five minutes. If it lapses before the bytes land, call this again for a fresh one rather than reusing the id. size_bytes has to be the exact number of bytes you are about to upload, because it is signed into the URL and storage refuses a body of any other length. Use share_text instead when you already hold the text and want it published in a single call.

List the links on this account, newest first, with the URL and details of each. Use it to find a link you shared earlier, to check whether something is still up, or to see what an account already holds before adding to it. Returns up to 50 links by default and 100 at most. When more exist, the reply ends with a cursor to pass back for the next page, and says plainly when there are none left. Deleted links are never included.

Publish text at a public URL and get the link back. Accepts up to 2MB of content, measured in UTF-8 bytes. A filename ending in .html or .htm produces a page that renders live in the browser at its own nudgehost.site address. A .csv or .json file opens in NudgeHost's table or JSON viewer. A .md or .markdown file shows as formatted text, with headings, lists, tables, task lists and links, a Source view, a Copy source button and a raw text address; HTML inside it shows as typed and images are not loaded. Any other filename, including .txt, produces a page that shows the text as plain text, with a Copy text button and a raw text address. The link is public: anyone who has it can open the file without signing in.