Changeset View
Changeset View
Standalone View
Standalone View
docs/specs/protocol-reference.rst
| Show First 20 Lines • Show All 69 Lines • ▼ Show 20 Lines | |||||
| and every package in Debian/NPM/PyPI is also an origin. | and every package in Debian/NPM/PyPI is also an origin. | ||||
| While origin URLs are not required to resolve to a source code artifact, | While origin URLs are not required to resolve to a source code artifact, | ||||
| we recommend they point to a public resource describing the software project, | we recommend they point to a public resource describing the software project, | ||||
| including a link to download its source code. | including a link to download its source code. | ||||
| This is not a technical requirement, but it improves discoverability. | This is not a technical requirement, but it improves discoverability. | ||||
| Clients may not submit arbitrary URLs; the server will check the URLs they submit | Clients may not submit arbitrary URLs; the server will check the URLs they submit | ||||
| belongs a "namespace" they own, known as the ``provider_url`` of the client. | belongs to a "namespace" they own, known as the ``provider_url`` of the client. For | ||||
| For example, if a client has their ``provider_url`` set to ``https://example.org/foo/`` | example, if a client has their ``provider_url`` set to ``https://example.org/foo/`` they | ||||
| they will not be able to submit deposits to origins whose URL starts with | will only be able to submit deposits to origins whose URL starts with | ||||
| ``https://example.org/foo/``. | ``https://example.org/foo/``. | ||||
| Fallbacks | Fallbacks | ||||
| ^^^^^^^^^ | ^^^^^^^^^ | ||||
| If the ``<swhdeposit:create_origin>`` is not provided (either because they are generic | If the ``<swhdeposit:create_origin>`` is not provided (either because they are generic | ||||
| SWORDv2 implementations or old implementations of an swh-deposit client), the server | SWORDv2 implementations or old implementations of an swh-deposit client), the server | ||||
| falls back to creating one based on the ``provider_url`` and the ``Slug`` header | falls back to creating one based on the ``provider_url`` and the ``Slug`` header | ||||
| ▲ Show 20 Lines • Show All 272 Lines • Show Last 20 Lines | |||||