Jump to

• Request
• Response
• Examples

Get the Number of Blocks

get

/console/admin/api/v2/dashboard/statistics/blocks

Get the number of blocks.

Request

Supported Media Types

• application/json

Query Parameters

• channel(optional): string
  Channel name
• endTime(optional): string
  The end time of a time range in the format 'yyyyMMddhhmmss'
• startTime(optional): string
  The start time of a time range in the format 'yyyyMMddhhmmss'

Back to Top

Response

Supported Media Types

• application/json

200 Response

Response with a series of blocks by restriction

Body ()

Root Schema : schema

Type: object

Show Source

• data(optional): object StatsBlocks

{
    "type":"object",
    "properties":{
        "data":{
            "$ref":"#/definitions/StatsBlocks"
        }
    }
}

Nested Schema : StatsBlocks

Type: object

Show Source

• blocks(optional): array blocks

{
    "type":"object",
    "properties":{
        "blocks":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/StatsTransInfo"
            }
        }
    }
}

Nested Schema : blocks

Type: array

Show Source

• Array of: object StatsTransInfo

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/StatsTransInfo"
    }
}

Nested Schema : StatsTransInfo

Type: object

Show Source

• channelName(optional): string
• endTime(optional): string
• startTime(optional): string
• trans(optional): number

{
    "type":"object",
    "properties":{
        "channelName":{
            "type":"string"
        },
        "startTime":{
            "type":"string"
        },
        "endTime":{
            "type":"string"
        },
        "trans":{
            "type":"number"
        }
    }
}

400 Response

Invalid arguments

Body ()

Root Schema : 400errorModels

Type: object

Show Source

• key(optional): string
• value(optional): string

{
    "type":"object",
    "properties":{
        "key":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    },
    "example":{
        "respMesg":"invalid argument"
    }
}

Example:

{
    "respMesg":"invalid argument"
}

Default Response

Unexpected error

Body ()

Root Schema : errorModel

Type: object

Show Source

• code: integer(int32)
• message: string

{
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"integer",
            "format":"int32"
        },
        "message":{
            "type":"string"
        }
    }
}

Back to Top

Examples

This endpoint is used to get the number of commits on a specified channel or on all channels in a specified time range. The result is a JSON file including the total number of the specified scope in the specified time range. This API is only applicable for a founder instance.

The following example shows how to generate the block metrics by submitting a GET request on the REST resource using cURL.

curl -X GET -u username:password -k 
"http://<rest_server_url>:port/console/admin/api/v2/dashboard/statistics/blocks?channel=<channel>&startTime=<yyyymmddhhmmss>&endTime=<yyyymmddhhmmss>"

For example,

curl -X GET -u [e-mail]:mypswd -k 
"http://server.oracle.com:10000/console/admin/api/v2/dashboard/blocks?channel=tfzch01&startTime=20210224030000&endTime=20210224050000"

Example of the Response Body

The following example shows the contents of the response body in JSON format:

{
  "data": {
    "blocks": [
      {
        "channelName": "tfzch01",
        "startTime": "Sun, 24 Feb 2021 03:00:00 GMT",
        "endTime": "Sun, 24 Feb 2021 05:00:00 GMT",
        "trans": 2
      }
    ]
  }
}

Back to Top