GET /bridge
Response Body: JSON
{ "bridge-version" : "", "supported-checksum-types" : "" # Possible values: MD5, SHA-256, SHA-512 } |
POST /bridge/register
Request Body: JSON
{ "gateway-url" : "", # Endpoint URL where the Bridge can call back to this OTM API "gateway-username" : "", # Credentials to allow the Bridge to make calls back into the OTM API "gateway-password" : "" # Credentials to allow the Bridge to make calls back into the OTM API } |
POST /bridge/deposit ? {checksum-type}
checksum-type
: (Optional) Applies to all file checksums (can be one of: MD5, SHA-256, SHA-512). Default is MD5.Request Body: JSON
{ "object-1-id": { "file-1-id" : "file-1-checksum", "file-2-id" : "file-2-checksum" }, "object-2-id": { "file-3-id" : "file-1-checksum", "file-4-id" : "file-2-checksum" } } |
Response Body: JSON
{ "deposit-id" : "" } |
Notes:
There is no guarantee that all files in a single deposit request will be deposited into the DDP at the same time. This allows the Bridge to manage transfers based on available resources (so as to not over-run local disk, for example).
GET /bridge/deposit ? {status}
status:
(Optional) Limit list to deposits in a specific statusResponse Body: JSON
{ "deposit-id-1" : { "files" : "", # Number of files in deposit "status" : "" # Current deposit status }, # Additional deposits listed here } |
GET /bridge/deposit/{deposit-id}
Response Body: JSON
{ "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 } |
DELETE /bridge/deposit/{deposit-id}
Response Body: JSON
{ "details" : "", # In the event of a rejected call, information about why the call could not be performed will be provided here } |
POST /bridge/deposit/{deposit-id}/restart
POST /bridge/delete ? {checksum-type}
# Using POST rather than DELETE, allows for deleting multiple files (and is consistent with Restore action)checksum-type
: (Optional) if provided, applies to all file checksums (can be one of: MD5, SHA-256, SHA-512). Default is MD5.Request Body: JSON
{ "file-1-id" : "file-1-checksum", # Checksum is optional, can be included to verify correct file is being deleted "file-2-id" : "file-2-checksum" } |
Response Body: JSON
{ "delete-id" : "" } |
GET /bridge/delete ? {status}
status:
(Optional) Limit list to deletes actions with a specific statusResponse Body: JSON
{ "delete-id-1" : { "files" : "", # Number of files in delete action "status" : "" # Current delete status }, # Additional delete actions listed here } |
GET /bridge/delete/{delete-id}
Response Body: JSON
{ "status" : "" } # This could include a top level status or a per-file status (or both) |
POST /bridge/audit ? {id-type}
Request Body: JSON
{ "id-1", "id-2", ... } |
Response Body: JSON
{ "audit-report-id" : "" } |
Response Body: JSON
{ "file-1-id" : { "audit-event-1", "audit-event-2", }, } |
POST /bridge/restore ? {checksum-type}
checksum-type
: (Optional) if provided, applies to all file checksums (can be one of: MD5, SHA-256, SHA-512). Default is MD5.Request Body: JSON
{ "file-1-id" : "file-1-checksum", # Checksum is optional, can be included to verify correct file is being restored "file-2-id" : "file-2-checksum" } |
Response Code: 202 (on success)
Response Body: JSON
{ "restore-id" : "" } |
GET /bridge/restore/{restore-id}
Response Body: JSON
{ "status" : "" } # This could include a top level status or a per-file status (or both) |
GET /bridge/restore/{restore-id}/{file-id} ? {checksum-type}
checksum-type
: (Optional) Defines the type of checksum to be included in the response ETag header. Can be one of: MD5, SHA-256, SHA-512. Default is MD5.Response: Restored file content stream