Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Purpose: Allows a repository with an OTM API to register itself with the Bridge
  • Request: POST /bridge/register
  • Request Body: JSON 

    Code Block
    languagejs
    {
      "otm-url" : "",      # Endpoint URL where the Bridge can call back to this OTM API
      "otm-username" : "", # Credentials to allow the Bridge to make calls back into the OTM API
      "otm-password" : ""  # Credentials to allow the Bridge to make calls back into the OTM API
    }


  • Response Code: 200 (on success)

Deposit

...

Content

  • Purpose: Allows the repository to send content to the Bridge for deposit into the DDP
  • Request: POST /bridge/deposit/{deposit-id}
  • Request Body: JSON 

    Code Block
    {
      "checksum-type" : "SHA-256",
      "deposit-id" : {
        "file-1-id" : {
          "url" : "",               # This could be a relative URL to the file, based on the otm-url provided in the bridge registration
          "checksum" : "abc123"
        },                          # Additional files are added here                                
      }
    }


  • Response Code: 201 (on success)

Deposit

...

Status

  • Purpose: Allows the repository to ask for status of a given deposit
  • Request: GET /bridge/deposit/{deposit-id}
  • Response Code 200 (on success)
  • Response Body: JSON 

    Code Block
    {
      "deposit-id" : "",
      "status" : "",     # Value based on defined set of known status states
                         # There could be more information here, like an approximate percentage completion of the current step, if known
    }



Abort

...

Deposit

  • Purpose: Allows the repository to ask the Bridge to abort the deposit process
  • Request: DELETE /bridge/deposit/{deposit-id}
  • Response: 200 (on success)

Restart

...

Deposit

  • Purpose: Allows the repository to ask the Bridge to re-start a deposit that failed. For example, if the repository became unavailable shortly after starting a deposit and the Bridge process failed due to this, or if a single file in the deposit was not in the repository when the Bridge attempted to retrieve it.
  • Request: POST /bridge/{deposit-id}/restart
  • Response Code: 202 (on success)

Delete Content

  • TBD

Get Audit History

  • TBD

Retrieve Content

  • TBD