Chilkat Online Tools

delphiAx / Squadcast API V3 / Update On-call Event

Back to Collection Items

var
http: TChilkatHttp;
success: Integer;
json: TChilkatJsonObject;
sbRequestBody: TChilkatStringBuilder;
resp: IChilkatHttpResponse;
sbResponseBody: TChilkatStringBuilder;
jResp: TChilkatJsonObject;
respStatusCode: Integer;
id: WideString;
start_time: WideString;
end_time: WideString;
name: WideString;
series_id: WideString;
is_override: Integer;
schedule_id: WideString;
Id: WideString;
Name: WideString;
Slug: WideString;
j: Integer;
count_j: Integer;
strVal: WideString;
i: Integer;
count_i: Integer;

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

http := TChilkatHttp.Create(Self);

// 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"
//     }
//   }
// }

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

// Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken := '<access_token>';

sbRequestBody := TChilkatStringBuilder.Create(Self);
json.EmitSb(sbRequestBody.ControlInterface);

resp := http.PTextSb('PUT','https://api.squadcast.com/v3/schedules/:schedulesID/events/:eventID',sbRequestBody.ControlInterface,'utf-8','application/json',0,0);
if (http.LastMethodSuccess = 0) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

sbResponseBody := TChilkatStringBuilder.Create(Self);
resp.GetBodySb(sbResponseBody.ControlInterface);

jResp := TChilkatJsonObject.Create(Self);
jResp.LoadSb(sbResponseBody.ControlInterface);
jResp.EmitCompact := 0;

Memo1.Lines.Add('Response Body:');
Memo1.Lines.Add(jResp.Emit());

respStatusCode := resp.StatusCode;
Memo1.Lines.Add('Response Status Code = ' + IntToStr(respStatusCode));
if (respStatusCode >= 400) then
  begin
    Memo1.Lines.Add('Response Header:');
    Memo1.Lines.Add(resp.Header);
    Memo1.Lines.Add('Failed.');

    Exit;
  end;

// 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;
count_i := jResp.SizeOfArray('data');
while i < count_i do
  begin
    jResp.I := i;
    id := jResp.StringOf('data[i].id');
    start_time := jResp.StringOf('data[i].start_time');
    end_time := jResp.StringOf('data[i].end_time');
    name := jResp.StringOf('data[i].name');
    series_id := jResp.StringOf('data[i].series_id');
    is_override := jResp.BoolOf('data[i].is_override');
    schedule_id := jResp.StringOf('data[i].schedule_id');
    Id := jResp.StringOf('data[i].calendar.id');
    Name := jResp.StringOf('data[i].calendar.name');
    Slug := jResp.StringOf('data[i].calendar.slug');
    j := 0;
    count_j := jResp.SizeOfArray('data[i].user_ids');
    while j < count_j do
      begin
        jResp.J := j;
        strVal := jResp.StringOf('data[i].user_ids[j]');
        j := j + 1;
      end;

    j := 0;
    count_j := jResp.SizeOfArray('data[i].squad_ids');
    while j < count_j do
      begin
        jResp.J := j;
        j := j + 1;
      end;

    i := i + 1;
  end;

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}"
    }
  ]
}