Provider v0.4.0

Ocean Provider is the technical component executed by Data Providers allowing them to provide extended data services. When running with our Docker images, it is exposed under http://localhost:8030.

/api/v1/services/compute

delete

Deletes a workflow.

Parameters

signaturestring

Signature of the documentId to verify that the consumer has rights to download the asset.

documentId*string

The ID of the asset

consumerAddress*string

The consumer address.

jobIdstring

JobId.

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Invalid asset data.
500 Error

get

Get status for a specific jobId/documentId/owner

Parameters

signaturestring

Signature of (consumerAddress+jobId+documentId) to verify the consumer of this asset/compute job. The signature uses ethereum based signing method (see https://github.com/ethereum/EIPs/pull/683)

documentId*string

The ID of the asset. If not provided, the status of all currently running and old compute jobs for the specified consumerAddress will be returned.

consumerAddress*string

The consumer ethereum address.

jobIdstring

The ID of the compute job. If not provided, all running compute jobs of the specified consumerAddress/documentId are suspended

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Consumer signature is invalid or failed verification.
500 General server error

post

Call the execution of a workflow.

Parameters

signaturestring

Signature of (consumerAddress+jobId+documentId) to verify the consumer of this asset/compute job. The signature uses ethereum based signing method (see https://github.com/ethereum/EIPs/pull/683)

consumerAddress*string

The consumer ethereum address.

algorithmDidstring

The DID of the algorithm Asset to be executed

algorithmMetajson string

json object that define the algorithm attributes and url or raw code

output*json string

json object that define the output section

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Consumer signature is invalid or failed verification
500 General server error

put

Stop the execution of a workflow.

Parameters

signaturestring

Signature of (consumerAddress+jobId+documentId) to verify the consumer of this compute job/asset. The signature uses ethereum based signing method (see https://github.com/ethereum/EIPs/pull/683)

documentId*string

The ID of the asset. If not provided, all currently running compute jobs will be stopped for the specified consumerAddress

consumerAddress*string

The consumer ethereum address.

jobIdstring

The ID of the compute job. If not provided, all running compute jobs of the specified consumerAddress/documentId are suspended

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Consumer signature is invalid or failed verification.
500 General server error

/api/v1/services/download

get

Allows download of asset data file.

Parameters

consumerAddress*string

The consumer address.

documentId*string

The ID of the asset/document (the DID).

url*string

This URL is only valid if Provider acts as a proxy. Consumer can't download using the URL if it's not through the Provider.

signature

Signature of the documentId to verify that the consumer has rights to download the asset.

index

Index of the file in the array of files.

Responses

200 Redirect to valid asset url.
400 One of the required attributes is missing.
401 Invalid asset data.
500 Error