# Generated by Scrape::ApiDefinitionsJob: 2018-09-25 01:15:43 UTC
# See: https://git.io/vx5CY
---
- name: :block_api
  description: 'Used to query values related to the block plugin. **These AppBase
    API methods are still under development and subject to change.**

'
  methods:
  - api_method: block_api.get_block
    purpose: |
      Retrieve a full, signed block of the referenced block, or null if no matching block was found.

      **Parameters:**

        * `block_num:int`

      | `block_num` (int) | |
      |-------------------|-|
      | `1` | Queries the very first block. |
      | `8675309` | Queries block number 8,675,309. |
      | `62396745` | Queries block number 62,396,745. |
    parameter_json: '{"block_num":0}'
    expected_response_json: |
      {
        "block": {
          "previous": "0000000000000000000000000000000000000000",
          "timestamp": "2016-03-24T16:05:00",
          "witness": "",
          "transaction_merkle_root": "0000000000000000000000000000000000000000",
          "extensions": [],
          "witness_signature": "",
          "transactions": [],
          "block_id": "",
          "signing_key": "",
          "transaction_ids": []
        }
      }
    curl_examples:
    - '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":1},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":8675309},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":62396745},
      "id":1}'
    client_docs:
      - '[hive-js](https://gitlab.syncad.com/hive/hive-js/tree/master/doc#get-block)'
      - '[beem](https://beem.readthedocs.io/en/latest/apidefinitions.html#get-block)'
      - '[hive-ruby](https://www.rubydoc.info/gems/hive-ruby/Hive/BlockApi)'
  - api_method: block_api.get_block_header
    purpose: "Retrieve a block header of the referenced block, or null if no matching
      block was found.\n\n**Parameters:**\n  \n  * `block_num:int` - Height of the
      block whose header should be returned\n\n| `block_num` (int) | |\n|-------------------|-|\n|
      `1` | Queries the block headers for the very first block. |\n| `8675309` | Queries
      block headers for block number 8,675,309. |\n| `62396745` | Queries block headers
      for block number 62,396,745. |\n"
    parameter_json: '{"block_num":0}'
    expected_response_json: |
      {
        "header": {
          "previous": "0000000000000000000000000000000000000000",
          "timestamp": "2016-03-24T16:05:00",
          "witness": "",
          "transaction_merkle_root": "0000000000000000000000000000000000000000",
          "extensions": []
        }
      }
    curl_examples:
    - '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":1},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":8675309},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":62396745},
      "id":1}'
    client_docs:
      - '[hive-js](https://gitlab.syncad.com/hive/hive-js/tree/master/doc#get-block-header)'
      - '[beem](https://beem.readthedocs.io/en/latest/apidefinitions.html#get-block-header)'
      - '[hive-ruby](https://www.rubydoc.info/gems/hive-ruby/Hive/BlockApi)'
