Chilkat Online Tools

TCL / Datadog API Collection / Get all notebooks

Back to Collection Items

load ./chilkat.dll

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

set http [new_CkHttp]

set queryParams [new_CkJsonObject]

CkJsonObject_UpdateString $queryParams "author_handle" "test@datadoghq.com"
CkJsonObject_UpdateString $queryParams "exclude_author_handle" "test@datadoghq.com"
CkJsonObject_UpdateInt $queryParams "start" 0
CkJsonObject_UpdateInt $queryParams "count" 5
CkJsonObject_UpdateString $queryParams "sort_field" "modified"
CkJsonObject_UpdateString $queryParams "sort_dir" "desc"
CkJsonObject_UpdateString $queryParams "query" "postmortem"
CkJsonObject_UpdateString $queryParams "include_cells" "false"
CkJsonObject_UpdateString $queryParams "is_template" "false"
CkJsonObject_UpdateString $queryParams "type" "investigation"

CkHttp_SetRequestHeader $http "Accept" "application/json"

# resp is a CkHttpResponse
set resp [CkHttp_QuickRequestParams $http "GET" "https://api.app.ddog-gov.com/api/v1/notebooks" $queryParams]
if {[CkHttp_get_LastMethodSuccess $http] == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkJsonObject $queryParams
    exit
}

set sbResponseBody [new_CkStringBuilder]

CkHttpResponse_GetBodySb $resp $sbResponseBody

set jResp [new_CkJsonObject]

CkJsonObject_LoadSb $jResp $sbResponseBody
CkJsonObject_put_EmitCompact $jResp 0

puts "Response Body:"
puts [CkJsonObject_emit $jResp]

set respStatusCode [CkHttpResponse_get_StatusCode $resp]
puts "Response Status Code = $respStatusCode"
if {$respStatusCode >= 400} then {
    puts "Response Header:"
    puts [CkHttpResponse_header $resp]
    puts "Failed."
    delete_CkHttpResponse $resp

    delete_CkHttp $http
    delete_CkJsonObject $queryParams
    delete_CkStringBuilder $sbResponseBody
    delete_CkJsonObject $jResp
    exit
}

delete_CkHttpResponse $resp

# Sample JSON response:
# (Sample code for parsing the JSON response is shown below)

# {
#   "data": [
#     {
#       "id": 123456,
#       "type": "notebooks",
#       "attributes": {
#         "name": "Example Notebook",
#         "author": {
#           "created_at": "1981-07-01T19:18:52.706Z",
#           "disabled": true,
#           "email": "enim fugiat",
#           "handle": "in",
#           "icon": "ut laborum",
#           "name": "ex sunt dolore eiusmod",
#           "status": "in nisi non velit adipisicing",
#           "title": "veniam dolor",
#           "verified": false
#         },
#         "cells": [
#           {
#             "id": "abcd1234",
#             "type": "notebook_cells",
#             "attributes": {
#               "definition": {
#                 "type": "markdown",
#                 "text": "# Example Header \nexample content"
#               }
#             }
#           },
#           {
#             "id": "abcd1234",
#             "type": "notebook_cells",
#             "attributes": {
#               "definition": {
#                 "type": "markdown",
#                 "text": "# Example Header \nexample content"
#               }
#             }
#           }
#         ],
#         "created": "2021-02-24T23:14:15.173964+00:00",
#         "metadata": {
#           "is_template": false,
#           "take_snapshots": false,
#           "type": "investigation"
#         },
#         "modified": "2021-02-24T23:15:23.274966+00:00",
#         "status": "published",
#         "time": {
#           "live_span": "1h"
#         }
#       }
#     },
#     {
#       "id": 123456,
#       "type": "notebooks",
#       "attributes": {
#         "name": "Example Notebook",
#         "author": {
#           "created_at": "1984-05-01T21:20:20.424Z",
#           "disabled": true,
#           "email": "cillum",
#           "handle": "et in Excepteur sunt aute",
#           "icon": "minim dolore sint eu deserunt",
#           "name": "ex reprehenderit labore",
#           "status": "dolor consectetur",
#           "title": "ex ut dolore",
#           "verified": true
#         },
#         "cells": [
#           {
#             "id": "abcd1234",
#             "type": "notebook_cells",
#             "attributes": {
#               "definition": {
#                 "type": "markdown",
#                 "text": "# Example Header \nexample content"
#               }
#             }
#           },
#           {
#             "id": "abcd1234",
#             "type": "notebook_cells",
#             "attributes": {
#               "definition": {
#                 "type": "markdown",
#                 "text": "# Example Header \nexample content"
#               }
#             }
#           }
#         ],
#         "created": "2021-02-24T23:14:15.173964+00:00",
#         "metadata": {
#           "is_template": false,
#           "take_snapshots": false,
#           "type": "investigation"
#         },
#         "modified": "2021-02-24T23:15:23.274966+00:00",
#         "status": "published",
#         "time": {
#           "live_span": "1h"
#         }
#       }
#     }
#   ],
#   "meta": {
#     "page": {
#       "total_count": 83637833,
#       "total_filtered_count": 34015219
#     }
#   }
# }

# Sample code for parsing the JSON response...
# Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

set Total_count [CkJsonObject_IntOf $jResp "meta.page.total_count"]
set Total_filtered_count [CkJsonObject_IntOf $jResp "meta.page.total_filtered_count"]
set i 0
set count_i [CkJsonObject_SizeOfArray $jResp "data"]
while {$i < $count_i} {
    CkJsonObject_put_I $jResp $i
    set id [CkJsonObject_IntOf $jResp "data[i].id"]
    set v_type [CkJsonObject_stringOf $jResp "data[i].type"]
    set Name [CkJsonObject_stringOf $jResp "data[i].attributes.name"]
    set Created_at [CkJsonObject_stringOf $jResp "data[i].attributes.author.created_at"]
    set Disabled [CkJsonObject_BoolOf $jResp "data[i].attributes.author.disabled"]
    set v_Email [CkJsonObject_stringOf $jResp "data[i].attributes.author.email"]
    set Handle [CkJsonObject_stringOf $jResp "data[i].attributes.author.handle"]
    set Icon [CkJsonObject_stringOf $jResp "data[i].attributes.author.icon"]
    set AuthorName [CkJsonObject_stringOf $jResp "data[i].attributes.author.name"]
    set Status [CkJsonObject_stringOf $jResp "data[i].attributes.author.status"]
    set Title [CkJsonObject_stringOf $jResp "data[i].attributes.author.title"]
    set Verified [CkJsonObject_BoolOf $jResp "data[i].attributes.author.verified"]
    set Created [CkJsonObject_stringOf $jResp "data[i].attributes.created"]
    set Is_template [CkJsonObject_BoolOf $jResp "data[i].attributes.metadata.is_template"]
    set Take_snapshots [CkJsonObject_BoolOf $jResp "data[i].attributes.metadata.take_snapshots"]
    set v_Type [CkJsonObject_stringOf $jResp "data[i].attributes.metadata.type"]
    set Modified [CkJsonObject_stringOf $jResp "data[i].attributes.modified"]
    set attributesStatus [CkJsonObject_stringOf $jResp "data[i].attributes.status"]
    set Live_span [CkJsonObject_stringOf $jResp "data[i].attributes.time.live_span"]
    set j 0
    set count_j [CkJsonObject_SizeOfArray $jResp "data[i].attributes.cells"]
    while {$j < $count_j} {
        CkJsonObject_put_J $jResp $j
        set id_str [CkJsonObject_stringOf $jResp "data[i].attributes.cells[j].id"]
        set v_type [CkJsonObject_stringOf $jResp "data[i].attributes.cells[j].type"]
        set DefinitionType [CkJsonObject_stringOf $jResp "data[i].attributes.cells[j].attributes.definition.type"]
        set Text [CkJsonObject_stringOf $jResp "data[i].attributes.cells[j].attributes.definition.text"]
        set j [expr $j + 1]
    }
    set i [expr $i + 1]
}

delete_CkHttp $http
delete_CkJsonObject $queryParams
delete_CkStringBuilder $sbResponseBody
delete_CkJsonObject $jResp

Curl Command

curl -G -d "author_handle=test%40datadoghq.com"
	-d "exclude_author_handle=test%40datadoghq.com"
	-d "start=0"
	-d "count=5"
	-d "sort_field=modified"
	-d "sort_dir=desc"
	-d "query=postmortem"
	-d "include_cells=false"
	-d "is_template=false"
	-d "type=investigation"
	-H "Accept: application/json"
https://api.app.ddog-gov.com/api/v1/notebooks

Postman Collection Item JSON

{
  "name": "Get all notebooks",
  "request": {
    "method": "GET",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "url": {
      "raw": "{{baseUrl}}/api/v1/notebooks?author_handle=test@datadoghq.com&exclude_author_handle=test@datadoghq.com&start=0&count=5&sort_field=modified&sort_dir=desc&query=postmortem&include_cells=false&is_template=false&type=investigation",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "api",
        "v1",
        "notebooks"
      ],
      "query": [
        {
          "key": "author_handle",
          "value": "test@datadoghq.com",
          "description": "Return notebooks created by the given `author_handle`."
        },
        {
          "key": "exclude_author_handle",
          "value": "test@datadoghq.com",
          "description": "Return notebooks not created by the given `author_handle`."
        },
        {
          "key": "start",
          "value": "0",
          "description": "The index of the first notebook you want returned."
        },
        {
          "key": "count",
          "value": "5",
          "description": "The number of notebooks to be returned."
        },
        {
          "key": "sort_field",
          "value": "modified",
          "description": "Sort by field `modified`, `name`, or `created`."
        },
        {
          "key": "sort_dir",
          "value": "desc",
          "description": "Sort by direction `asc` or `desc`."
        },
        {
          "key": "query",
          "value": "postmortem",
          "description": "Return only notebooks with `query` string in notebook name or author handle."
        },
        {
          "key": "include_cells",
          "value": "false",
          "description": "Value of `false` excludes the `cells` and global `time` for each notebook."
        },
        {
          "key": "is_template",
          "value": "false",
          "description": "True value returns only template notebooks. Default is false (returns only non-template notebooks)."
        },
        {
          "key": "type",
          "value": "investigation",
          "description": "If type is provided, returns only notebooks with that metadata type. Default does not have type filtering."
        }
      ]
    },
    "description": "Get all notebooks. This can also be used to search for notebooks with a particular `query` in the notebook\n`name` or author `handle`."
  },
  "response": [
    {
      "name": "OK",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/notebooks?author_handle=test@datadoghq.com&exclude_author_handle=test@datadoghq.com&start=0&count=5&sort_field=modified&sort_dir=desc&query=postmortem&include_cells=false&is_template=false&type=investigation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "notebooks"
          ],
          "query": [
            {
              "key": "author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks created by the given `author_handle`."
            },
            {
              "key": "exclude_author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks not created by the given `author_handle`."
            },
            {
              "key": "start",
              "value": "0",
              "description": "The index of the first notebook you want returned."
            },
            {
              "key": "count",
              "value": "5",
              "description": "The number of notebooks to be returned."
            },
            {
              "key": "sort_field",
              "value": "modified",
              "description": "Sort by field `modified`, `name`, or `created`."
            },
            {
              "key": "sort_dir",
              "value": "desc",
              "description": "Sort by direction `asc` or `desc`."
            },
            {
              "key": "query",
              "value": "postmortem",
              "description": "Return only notebooks with `query` string in notebook name or author handle."
            },
            {
              "key": "include_cells",
              "value": "false",
              "description": "Value of `false` excludes the `cells` and global `time` for each notebook."
            },
            {
              "key": "is_template",
              "value": "false",
              "description": "True value returns only template notebooks. Default is false (returns only non-template notebooks)."
            },
            {
              "key": "type",
              "value": "investigation",
              "description": "If type is provided, returns only notebooks with that metadata type. Default does not have type filtering."
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"data\": [\n    {\n      \"id\": 123456,\n      \"type\": \"notebooks\",\n      \"attributes\": {\n        \"name\": \"Example Notebook\",\n        \"author\": {\n          \"created_at\": \"1981-07-01T19:18:52.706Z\",\n          \"disabled\": true,\n          \"email\": \"enim fugiat\",\n          \"handle\": \"in\",\n          \"icon\": \"ut laborum\",\n          \"name\": \"ex sunt dolore eiusmod\",\n          \"status\": \"in nisi non velit adipisicing\",\n          \"title\": \"veniam dolor\",\n          \"verified\": false\n        },\n        \"cells\": [\n          {\n            \"id\": \"abcd1234\",\n            \"type\": \"notebook_cells\",\n            \"attributes\": {\n              \"definition\": {\n                \"type\": \"markdown\",\n                \"text\": \"# Example Header \\nexample content\"\n              }\n            }\n          },\n          {\n            \"id\": \"abcd1234\",\n            \"type\": \"notebook_cells\",\n            \"attributes\": {\n              \"definition\": {\n                \"type\": \"markdown\",\n                \"text\": \"# Example Header \\nexample content\"\n              }\n            }\n          }\n        ],\n        \"created\": \"2021-02-24T23:14:15.173964+00:00\",\n        \"metadata\": {\n          \"is_template\": false,\n          \"take_snapshots\": false,\n          \"type\": \"investigation\"\n        },\n        \"modified\": \"2021-02-24T23:15:23.274966+00:00\",\n        \"status\": \"published\",\n        \"time\": {\n          \"live_span\": \"1h\"\n        }\n      }\n    },\n    {\n      \"id\": 123456,\n      \"type\": \"notebooks\",\n      \"attributes\": {\n        \"name\": \"Example Notebook\",\n        \"author\": {\n          \"created_at\": \"1984-05-01T21:20:20.424Z\",\n          \"disabled\": true,\n          \"email\": \"cillum\",\n          \"handle\": \"et in Excepteur sunt aute\",\n          \"icon\": \"minim dolore sint eu deserunt\",\n          \"name\": \"ex reprehenderit labore\",\n          \"status\": \"dolor consectetur\",\n          \"title\": \"ex ut dolore\",\n          \"verified\": true\n        },\n        \"cells\": [\n          {\n            \"id\": \"abcd1234\",\n            \"type\": \"notebook_cells\",\n            \"attributes\": {\n              \"definition\": {\n                \"type\": \"markdown\",\n                \"text\": \"# Example Header \\nexample content\"\n              }\n            }\n          },\n          {\n            \"id\": \"abcd1234\",\n            \"type\": \"notebook_cells\",\n            \"attributes\": {\n              \"definition\": {\n                \"type\": \"markdown\",\n                \"text\": \"# Example Header \\nexample content\"\n              }\n            }\n          }\n        ],\n        \"created\": \"2021-02-24T23:14:15.173964+00:00\",\n        \"metadata\": {\n          \"is_template\": false,\n          \"take_snapshots\": false,\n          \"type\": \"investigation\"\n        },\n        \"modified\": \"2021-02-24T23:15:23.274966+00:00\",\n        \"status\": \"published\",\n        \"time\": {\n          \"live_span\": \"1h\"\n        }\n      }\n    }\n  ],\n  \"meta\": {\n    \"page\": {\n      \"total_count\": 83637833,\n      \"total_filtered_count\": 34015219\n    }\n  }\n}"
    },
    {
      "name": "Bad Request",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/notebooks?author_handle=test@datadoghq.com&exclude_author_handle=test@datadoghq.com&start=0&count=5&sort_field=modified&sort_dir=desc&query=postmortem&include_cells=false&is_template=false&type=investigation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "notebooks"
          ],
          "query": [
            {
              "key": "author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks created by the given `author_handle`."
            },
            {
              "key": "exclude_author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks not created by the given `author_handle`."
            },
            {
              "key": "start",
              "value": "0",
              "description": "The index of the first notebook you want returned."
            },
            {
              "key": "count",
              "value": "5",
              "description": "The number of notebooks to be returned."
            },
            {
              "key": "sort_field",
              "value": "modified",
              "description": "Sort by field `modified`, `name`, or `created`."
            },
            {
              "key": "sort_dir",
              "value": "desc",
              "description": "Sort by direction `asc` or `desc`."
            },
            {
              "key": "query",
              "value": "postmortem",
              "description": "Return only notebooks with `query` string in notebook name or author handle."
            },
            {
              "key": "include_cells",
              "value": "false",
              "description": "Value of `false` excludes the `cells` and global `time` for each notebook."
            },
            {
              "key": "is_template",
              "value": "false",
              "description": "True value returns only template notebooks. Default is false (returns only non-template notebooks)."
            },
            {
              "key": "type",
              "value": "investigation",
              "description": "If type is provided, returns only notebooks with that metadata type. Default does not have type filtering."
            }
          ]
        }
      },
      "status": "Bad Request",
      "code": 400,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"errors\": [\n    \"Bad Request\",\n    \"Bad Request\"\n  ]\n}"
    },
    {
      "name": "Authentication Error",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/notebooks?author_handle=test@datadoghq.com&exclude_author_handle=test@datadoghq.com&start=0&count=5&sort_field=modified&sort_dir=desc&query=postmortem&include_cells=false&is_template=false&type=investigation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "notebooks"
          ],
          "query": [
            {
              "key": "author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks created by the given `author_handle`."
            },
            {
              "key": "exclude_author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks not created by the given `author_handle`."
            },
            {
              "key": "start",
              "value": "0",
              "description": "The index of the first notebook you want returned."
            },
            {
              "key": "count",
              "value": "5",
              "description": "The number of notebooks to be returned."
            },
            {
              "key": "sort_field",
              "value": "modified",
              "description": "Sort by field `modified`, `name`, or `created`."
            },
            {
              "key": "sort_dir",
              "value": "desc",
              "description": "Sort by direction `asc` or `desc`."
            },
            {
              "key": "query",
              "value": "postmortem",
              "description": "Return only notebooks with `query` string in notebook name or author handle."
            },
            {
              "key": "include_cells",
              "value": "false",
              "description": "Value of `false` excludes the `cells` and global `time` for each notebook."
            },
            {
              "key": "is_template",
              "value": "false",
              "description": "True value returns only template notebooks. Default is false (returns only non-template notebooks)."
            },
            {
              "key": "type",
              "value": "investigation",
              "description": "If type is provided, returns only notebooks with that metadata type. Default does not have type filtering."
            }
          ]
        }
      },
      "status": "Forbidden",
      "code": 403,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"errors\": [\n    \"Bad Request\",\n    \"Bad Request\"\n  ]\n}"
    },
    {
      "name": "Too many requests",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "description": "Added as a part of security scheme: apikey",
            "key": "DD-API-KEY",
            "value": "<API Key>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v1/notebooks?author_handle=test@datadoghq.com&exclude_author_handle=test@datadoghq.com&start=0&count=5&sort_field=modified&sort_dir=desc&query=postmortem&include_cells=false&is_template=false&type=investigation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v1",
            "notebooks"
          ],
          "query": [
            {
              "key": "author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks created by the given `author_handle`."
            },
            {
              "key": "exclude_author_handle",
              "value": "test@datadoghq.com",
              "description": "Return notebooks not created by the given `author_handle`."
            },
            {
              "key": "start",
              "value": "0",
              "description": "The index of the first notebook you want returned."
            },
            {
              "key": "count",
              "value": "5",
              "description": "The number of notebooks to be returned."
            },
            {
              "key": "sort_field",
              "value": "modified",
              "description": "Sort by field `modified`, `name`, or `created`."
            },
            {
              "key": "sort_dir",
              "value": "desc",
              "description": "Sort by direction `asc` or `desc`."
            },
            {
              "key": "query",
              "value": "postmortem",
              "description": "Return only notebooks with `query` string in notebook name or author handle."
            },
            {
              "key": "include_cells",
              "value": "false",
              "description": "Value of `false` excludes the `cells` and global `time` for each notebook."
            },
            {
              "key": "is_template",
              "value": "false",
              "description": "True value returns only template notebooks. Default is false (returns only non-template notebooks)."
            },
            {
              "key": "type",
              "value": "investigation",
              "description": "If type is provided, returns only notebooks with that metadata type. Default does not have type filtering."
            }
          ]
        }
      },
      "status": "Too Many Requests",
      "code": 429,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"errors\": [\n    \"Bad Request\",\n    \"Bad Request\"\n  ]\n}"
    }
  ]
}