Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

The mechanism that applications use to communicate with Swarm is a text-based protocol based on HTTP. Known as theSimple Content Storage Protocol(SCSP), the methods and syntax are a proper subset of the HTTP/1.1 standard.

...

SCSP Method

HTTP Method

RFC 7231 Section

READ

GET

4.3.1

INFO

HEAD

4.3.2

WRITE

POST

4.3.3

UPDATE

PUT

4.3.4

DELETE

DELETE

4.3.5

n/a

CONNECT

4.3.6

n/a

OPTIONS

4.3.7

n/a

TRACE

4.3.8

APPEND



COPY



...

Most HTTP communication is initiated by a client application and consists of a request to be applied to an object on a Swarm server. This is performed using a single connection between the client application and the Swarm server. Being HTTP-based, SCSP protocol consists of HTTP requests and responses:

  • Requestsare generated by a Swarm client (that is, any HTTP/1.1 client), with these components:

  • Responsesare generated by one or more nodes in a storage cluster, with these components:

    • Status line, with the message's protocol version and a success or error code

    • MIME-like message, with server information, entity metadata, and possible entity-body content

See the  HTTP/1.1 specification for the semantics and nuances of HTTP.

...