docs: added examples for microblocks, accounts, transactions and non-fungible tokens (#1268)

* Added examples for missing API's

* fix the hash example for v1/block/{hash}

Author: LakshmiLavanyaKasturi

docs/openapi.yaml

@@ -543,7 +543,7 @@ paths:
         required: true
         schema:
           type: string
-          example: 0x044b6ee5bdc7d3cb16e9a263e892b8060b4f64c72900b02093b9f6fa74ae8a67
+          example: 0x3bfcdf84b3012adb544cf0f6df4835f93418c2269a3881885e27b3d58eb82d47
     get:
       summary: Get microblock
       description: Retrieves a specific microblock by `hash`
@@ -619,7 +619,7 @@ paths:
       - name: hash
         in: path
         description: Hash of the block
-        example: 0xbf06705d0b8c2389eb4b3a19ce72096b7158b158e2cd4ceb27d8de9db19bb3be
+        example: "0x4839a8b01cfb39ffcc0d07d3db31e848d5adf5279d529ed5062300b9f353ff79"
         required: true
         schema:
           type: string
@@ -1382,16 +1382,17 @@ paths:
         - name: principal
           in: path
           description: Stacks address or a contract identifier
-          example: SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0
           required: true
           schema:
             type: string
+            example: SP3FBR2AGK5H9QBDH3EEN6DF8EK8JY7RX8QJ5SVTE
         - name: tx_id
           in: path
           description: Transaction id
           required: true
           schema:
             type: string
+            example: 0x34d79c7cfc2fe525438736733e501a4bf0308a5556e3e080d1e2c0858aad7448
       responses:
         200:
           description: Success
@@ -1419,29 +1420,31 @@ paths:
         - name: principal
           in: path
           description: Stacks address or a Contract identifier
-          example: SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0
           required: true
           schema:
             type: string
+            example: SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0
         - name: limit
           in: query
           description: max number of account transactions to fetch
           required: false
           schema:
             type: integer
+            example: 20
         - name: offset
           in: query
           description: index of first account transaction to fetch
           required: false
-          example: 42000
           schema:
             type: integer
+            example: 10
         - name: height
           in: query
           description: Filter for transactions only at this given block height
           required: false
           schema:
             type: number
+            example: 66119
         - name: unanchored
           in: query
           description: Include transaction data from unanchored (i.e. unconfirmed) microblocks
@@ -1454,9 +1457,9 @@ paths:
           in: query
           description: returned data representing the state up until that point in time, rather than the current block.
           required: false
-          example: 60000
           schema:
             type: string
+            example: 60000
       responses:
         200:
           description: Success
@@ -1479,21 +1482,23 @@ paths:
           in: path
           description: Stacks address
           required: true
-          example: SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0
           schema:
             type: string
+            example: SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0
         - name: block_height
           in: query
           description: Optionally get the nonce at a given block height.
           required: false
           schema:
             type: number
+            example: 66119
         - name: block_hash
           in: query
           description: Optionally get the nonce at a given block hash. Note - Use either of the query parameters but not both at a time.
           required: false
           schema:
             type: string
+            example: 0x72d53f3cba39e149dcd42708e535bdae03d73e60d2fe853aaf61c0b392f521e9
 
       responses:
         200:
@@ -1526,13 +1531,14 @@ paths:
           required: false
           schema:
             type: integer
+            example: 20
         - name: offset
           in: query
           description: index of first account assets to fetch
           required: false
-          example: 42000
           schema:
             type: integer
+            example: 42000
         - name: unanchored
           in: query
           description: Include transaction data from unanchored (i.e. unconfirmed) microblocks
@@ -1545,9 +1551,9 @@ paths:
           in: query
           description: returned data representing the state at that point in time, rather than the current block. Note - Use either of the query parameters but not both at a time.
           required: false
-          example: 60000
           schema:
             type: string
+            example: 60000
       responses:
         200:
           description: Success
@@ -2849,7 +2855,7 @@ paths:
           in: path
           description: Height of block
           required: true
-          example: 69057
+          example: 66119
           schema:
             type: integer
         - name: limit
@@ -3187,6 +3193,7 @@ paths:
           required: false
           schema:
             type: integer
+            example: 1
         - name: offset
           in: query
           description: index of first tokens to fetch
@@ -3207,7 +3214,7 @@ paths:
   /extended/v1/tokens/{contractId}/nft/metadata:
     get:
       operationId: get_contract_nft_metadata
-      summary: Non fungible tokens metadata for contract id
+      summary: Non fungible tokens metadata for contract ID
       description: Retrieves metadata for non fungible tokens for a given contract id. More information on Non-Fungible Tokens on the Stacks blockchain can be found [here](https://docs.stacks.co/write-smart-contracts/tokens#non-fungible-tokens-nfts).
       tags:
         - Non-Fungible Tokens