Retrieve status ^^^^^^^^^^^^^^^^ .. http:get:: /1/(str:collection-name)/(int:deposit-id)/status/ Returns deposit's status. The different statuses: - **partial**: multipart deposit is still ongoing - **deposited**: deposit completed, ready for checks - **rejected**: deposit failed the checks - **verified**: content and metadata verified, ready for loading - **loading**: loading in-progress - **done**: loading completed successfully - **failed**: the deposit loading has failed Also known as STATE-IRI **Example query**: .. code:: http GET /1/hal/1/status/ HTTP/1.1 Host: deposit.softwareheritage.org Authorization: Basic xxxxxxxxxxxx= **Example successful deposit response**: .. code:: xml 160 done The deposit has been successfully loaded into the Software Heritage archive swh:1:dir:d83b7dda887dc790f7207608474650d4344b8df9 swh:1:dir:d83b7dda887dc790f7207608474650d4344b8df9;origin=https://forge.softwareheritage.org/source/jesuisgpl/;visit=swh:1:snp:68c0d26104d47e278dd6be07ed61fafb561d0d20;anchor=swh:1:rev:e76ea49c9ffbb7f73611087ba6e999b19e5d71eb;path=/ **Example rejeced deposit response**: .. code:: xml 148 rejected - At least one url field must be compatible with the client's domain name (codemeta:url) Note: older versions of the deposit used the ``http://www.w3.org/2005/Atom`` namespace instead of ``https://www.softwareheritage.org/schema/2018/deposit``. Tags in the Atom namespace are still provided for backward compatibility, but are deprecated. :reqheader Authorization: Basic authentication token :statuscode 201: with the deposit's status :statuscode 401: Unauthorized :statuscode 404: access to an unknown deposit Rejected deposit ~~~~~~~~~~~~~~~~ It so happens that deposit could be rejected. In that case, the `deposit_status_detail` entry will explain failed checks. Many reasons are possibles, here are some: - Deposit without software archive (main goal of the deposit is to deposit software source code) - Deposit with malformed software archive (i.e archive within archive) - Deposit with invalid software archive (corrupted archive, although, this one should happen during upload and not during checks) - Deposit with unsupported archive format - Deposit with missing metadata