SPsparkvault
sparks

Create a Spark

Changed on

Seal a read-once secret. It burns when it is read, and expires unread after ttl_minutes, a whole number of minutes. A text/uri-list Spark is a link Spark: it is created with its public x.sv link, which never outlives it.

post/sparks

Request

Request body

payloadstring required

UTF-8 text for a text media type, base64 for every other. At most 256000 bytes as sent.

content_typestring

Exactly one media type. text/uri-list makes a link Spark: the payload is the http or https URL it opens, and the answer carries its x.sv link.

ttl_minutesinteger

How long the Spark lives unread: a whole number of minutes. A fraction is refused with 400 VALIDATION_ERROR, never rounded.

filenamestring

The name a recipient saves the payload under, at most 255 characters. Stored in the shared file-name form: a character no file system accepts is replaced, and a name that shows only dots or spaces is none. A download saves under it, kept as it is when the first word of the extension it shows (up to an ASCII space, in any case) is one the MIME registry knows, whatever content_type, or holds a character none of the registry's extensions is spelled with, which may draw as one (a blank glyph, a letter of another script), and otherwise completed with the extension content_type's files are named with: the first the registry lists for it, or, for the few types whose first is not the one desktops name their files with, the one they do (.mp3 for audio/mpeg, .mov for video/quicktime), never one a saved copy must never open as; a read answers that name as download_filename.

kindlingstring

Join an existing kindling: the kindling an earlier create answered, kdl_ and 32 lowercase hex digits.

with_kindlingboolean

Start a new kindling, which the answer carries. Ignored when kindling is given.

bound_ipstring

A link Spark only: the client IP address its link opens for.

Response

The Spark, sealed.

Changes

  • a9a10e328ba5Revision changes
    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 56d7c265a77aRevision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status