Chilkat Online Tools

lianja / Squadcast API V3 / Update On-call Event

Back to Collection Items

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

loHttp = createobject("CkHttp")

// Use this online tool to generate code from sample JSON: Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "name": "SRE shift 1",
//   "update_type": 1,
//   "start_time": "2020-01-10T18:30:00.000Z",
//   "end_time": "2020-01-10T18:30:00.000Z",
//   "rotation_sets": [
//     {
//       "user_ids": [
//         "5d81d9187000fb6b9def7e31"
//       ],
//       "squad_ids": [
//       ]
//     },
//     {
//       "user_ids": [
//         "5d90cc3a4d031497494f07e6"
//       ],
//       "squad_ids": [
//       ]
//     }
//   ],
//   "config": {
//     "timezone": {
//       "name": "IST",
//       "offset": -330
//     },
//     "is_forever": true,
//     "until": "2020-01-09T14:38:06.658Z",
//     "rotate": true,
//     "repeat": true,
//     "rotation_frequency": 1,
//     "repetition": {
//       "frequency": 1,
//       "repeats_on": [
//         0,
//         6
//       ],
//       "type": "week"
//     }
//   }
// }

loJson = createobject("CkJsonObject")
loJson.UpdateString("name","SRE shift 1")
loJson.UpdateInt("update_type",1)
loJson.UpdateString("start_time","2020-01-10T18:30:00.000Z")
loJson.UpdateString("end_time","2020-01-10T18:30:00.000Z")
loJson.UpdateString("rotation_sets[0].user_ids[0]","5d81d9187000fb6b9def7e31")
loJson.UpdateNewArray("rotation_sets[0].squad_ids")
loJson.UpdateString("rotation_sets[1].user_ids[0]","5d90cc3a4d031497494f07e6")
loJson.UpdateNewArray("rotation_sets[1].squad_ids")
loJson.UpdateString("config.timezone.name","IST")
loJson.UpdateInt("config.timezone.offset",-330)
loJson.UpdateBool("config.is_forever",.T.)
loJson.UpdateString("config.until","2020-01-09T14:38:06.658Z")
loJson.UpdateBool("config.rotate",.T.)
loJson.UpdateBool("config.repeat",.T.)
loJson.UpdateInt("config.rotation_frequency",1)
loJson.UpdateInt("config.repetition.frequency",1)
loJson.UpdateInt("config.repetition.repeats_on[0]",0)
loJson.UpdateInt("config.repetition.repeats_on[1]",6)
loJson.UpdateString("config.repetition.type","week")

// Adds the "Authorization: Bearer <access_token>" header.
loHttp.AuthToken = "<access_token>"

loSbRequestBody = createobject("CkStringBuilder")
loJson.EmitSb(loSbRequestBody)

loResp = loHttp.PTextSb("PUT","https://api.squadcast.com/v3/schedules/:schedulesID/events/:eventID",loSbRequestBody,"utf-8","application/json",.F.,.F.)
if (loHttp.LastMethodSuccess = .F.) then
    ? loHttp.LastErrorText
    release loHttp
    release loJson
    release loSbRequestBody
    return
endif

loSbResponseBody = createobject("CkStringBuilder")
loResp.GetBodySb(loSbResponseBody)

loJResp = createobject("CkJsonObject")
loJResp.LoadSb(loSbResponseBody)
loJResp.EmitCompact = .F.

? "Response Body:"
? loJResp.Emit()

lnRespStatusCode = loResp.StatusCode
? "Response Status Code = " + str(lnRespStatusCode)
if (lnRespStatusCode >= 400) then
    ? "Response Header:"
    ? loResp.Header
    ? "Failed."
    release loResp
    release loHttp
    release loJson
    release loSbRequestBody
    release loSbResponseBody
    release loJResp
    return
endif

release loResp

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

// {
//   "data": [
//     {
//       "id": "5ecf89b4ebddeae2907cd424",
//       "start_time": "2020-01-10T18:30:00Z",
//       "end_time": "2020-01-10T18:30:00Z",
//       "name": "SRE shift 1",
//       "user_ids": [
//         "5d81d9187000fb6b9def7e31"
//       ],
//       "series_id": "5ecf89b4ebddeae2907cd423",
//       "squad_ids": [
//       ],
//       "is_override": false,
//       "schedule_id": "5ecf7176f92f2e731262b852",
//       "calendar": {
//         "id": "5ecf7176f92f2e731262b852",
//         "name": "Weekly schedule",
//         "slug": "weekly-schedule"
//       }
//     }
//   ]
// }

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

i = 0
lnCount_i = loJResp.SizeOfArray("data")
do while i < lnCount_i
    loJResp.I = i
    lcId = loJResp.StringOf("data[i].id")
    lcStart_time = loJResp.StringOf("data[i].start_time")
    lcEnd_time = loJResp.StringOf("data[i].end_time")
    lcName = loJResp.StringOf("data[i].name")
    lcSeries_id = loJResp.StringOf("data[i].series_id")
    llIs_override = loJResp.BoolOf("data[i].is_override")
    lcSchedule_id = loJResp.StringOf("data[i].schedule_id")
    lcId = loJResp.StringOf("data[i].calendar.id")
    lcName = loJResp.StringOf("data[i].calendar.name")
    lcSlug = loJResp.StringOf("data[i].calendar.slug")
    j = 0
    lnCount_j = loJResp.SizeOfArray("data[i].user_ids")
    do while j < lnCount_j
        loJResp.J = j
        lcStrVal = loJResp.StringOf("data[i].user_ids[j]")
        j = j + 1
    enddo
    j = 0
    lnCount_j = loJResp.SizeOfArray("data[i].squad_ids")
    do while j < lnCount_j
        loJResp.J = j
        j = j + 1
    enddo
    i = i + 1
enddo


release loHttp
release loJson
release loSbRequestBody
release loSbResponseBody
release loJResp

Curl Command

curl -X PUT
	-H "Authorization: Bearer <access_token>"
	-d '{
    "name": "SRE shift 1",
	"update_type":1,
    "start_time": "2020-01-10T18:30:00.000Z",
    "end_time": "2020-01-10T18:30:00.000Z",
    "rotation_sets": [
        {
            "user_ids": ["5d81d9187000fb6b9def7e31"],
            "squad_ids": []
        },
        {
            "user_ids": ["5d90cc3a4d031497494f07e6"],
            "squad_ids": []
        }
    ],
    "config": {
        "timezone": {
        	"name": "IST", 
        	"offset": -330
        },
        "is_forever": true,
        "until": "2020-01-09T14:38:06.658Z",
        "rotate": true,
        "repeat": true,
        "rotation_frequency": 1,
        "repetition": {
            "frequency": 1,
            "repeats_on": [
                0,
                6
            ],
            "type": "week"
        }
    }
}'
https://api.squadcast.com/v3/schedules/:schedulesID/events/:eventID

Postman Collection Item JSON

{
  "name": "Update On-call Event",
  "request": {
    "method": "PUT",
    "header": [
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"name\": \"SRE shift 1\",\n\t\"update_type\":1,\n    \"start_time\": \"2020-01-10T18:30:00.000Z\",\n    \"end_time\": \"2020-01-10T18:30:00.000Z\",\n    \"rotation_sets\": [\n        {\n            \"user_ids\": [\"5d81d9187000fb6b9def7e31\"],\n            \"squad_ids\": []\n        },\n        {\n            \"user_ids\": [\"5d90cc3a4d031497494f07e6\"],\n            \"squad_ids\": []\n        }\n    ],\n    \"config\": {\n        \"timezone\": {\n        \t\"name\": \"IST\", \n        \t\"offset\": -330\n        },\n        \"is_forever\": true,\n        \"until\": \"2020-01-09T14:38:06.658Z\",\n        \"rotate\": true,\n        \"repeat\": true,\n        \"rotation_frequency\": 1,\n        \"repetition\": {\n            \"frequency\": 1,\n            \"repeats_on\": [\n                0,\n                6\n            ],\n            \"type\": \"week\"\n        }\n    }\n}",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "{{baseUrl}}/schedules/:schedulesID/events/:eventID",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "schedules",
        ":schedulesID",
        "events",
        ":eventID"
      ],
      "variable": [
        {
          "key": "schedulesID",
          "value": "5ecf7176f92f2e731262b852",
          "type": "string"
        },
        {
          "key": "eventID",
          "value": "5ecf89b4ebddeae2907cd424",
          "type": "string"
        }
      ]
    },
    "description": "This endpoint is used to update the on-call rotation(event) for the schedule.\nRequires `access_token` as a `Bearer {{token}}` in the `Authorization` header with `schedule-write` scope.\n\nUpdate Type value representations:\n```\nupdate_type:\n\n1 - Update the current single event\n2 - Update the current event and all the following events\n```\n\n\nRepresentation of Weekly Repetition:\n```\n0 - Sunday\n1 - Monday\n2 - Tuesday\n3 - Wednesday\n4 - Thursday\n5 - Friday\n6 - Saturday\n```"
  },
  "response": [
    {
      "name": "200 OK",
      "originalRequest": {
        "method": "PUT",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n\t\"update_type\":1,\n    \"start_time\": \"2020-01-10T18:30:00.000Z\",\n    \"end_time\": \"2020-01-10T18:30:00.000Z\",\n    \"rotation_sets\": [\n        {\n            \"user_ids\": [\"5d81d9187000fb6b9def7e31\"],\n            \"squad_ids\": []\n        },\n        {\n            \"user_ids\": [\"5d90cc3a4d031497494f07e6\"],\n            \"squad_ids\": []\n        }\n    ],\n    \"config\": {\n        \"timezone\": {\n        \t\"name\": \"IST\", \n        \t\"offset\": -330\n        },\n        \"is_forever\": true,\n        \"until\": \"2020-01-09T14:38:06.658Z\",\n        \"rotate\": true,\n        \"repeat\": true,\n        \"rotation_frequency\": 1,\n        \"repetition\": {\n            \"frequency\": 1,\n            \"repeats_on\": [\n                0,\n                6\n            ],\n            \"type\": \"week\"\n        }\n    }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "{{baseUrl}}/schedules/:schedulesID/events/:eventID",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "schedules",
            ":schedulesID",
            "events",
            ":eventID"
          ],
          "variable": [
            {
              "key": "schedulesID",
              "value": "5ecf7176f92f2e731262b852"
            },
            {
              "key": "eventID",
              "value": "5ecf89b4ebddeae2907cd424"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        },
        {
          "key": "Vary",
          "value": "Origin"
        },
        {
          "key": "Date",
          "value": "Thu, 28 May 2020 10:24:09 GMT"
        },
        {
          "key": "Content-Length",
          "value": "406"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"data\": [\n        {\n            \"id\": \"5ecf89b4ebddeae2907cd424\",\n            \"start_time\": \"2020-01-10T18:30:00Z\",\n            \"end_time\": \"2020-01-10T18:30:00Z\",\n            \"name\": \"SRE shift 1\",\n            \"user_ids\": [\n                \"5d81d9187000fb6b9def7e31\"\n            ],\n            \"series_id\": \"5ecf89b4ebddeae2907cd423\",\n            \"squad_ids\": [],\n            \"is_override\": false,\n            \"schedule_id\": \"5ecf7176f92f2e731262b852\",\n            \"calendar\": {\n                \"id\": \"5ecf7176f92f2e731262b852\",\n                \"name\": \"Weekly schedule\",\n                \"slug\": \"weekly-schedule\"\n            }\n        }\n    ]\n}"
    }
  ]
}