Chilkat Online Tools

PureBasic / Sunshine Conversations API / Update App

Back to Collection Items

IncludeFile "CkJsonObject.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkHttpResponse.pb"

Procedure ChilkatExample()

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

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    CkHttp::setCkBasicAuth(http, 1)
    CkHttp::setCkLogin(http, "username")
    CkHttp::setCkPassword(http, "password")

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

    ; The following JSON is sent in the request body.

    ; {
    ;   "displayName": "nisi",
    ;   "settings": {
    ;     "conversationRetentionSeconds": 84530567,
    ;     "maskCreditCardNumbers": true,
    ;     "useAnimalNames": true,
    ;     "echoPostback": true,
    ;     "ignoreAutoConversationStart": true,
    ;     "multiConvoEnabled": true,
    ;     "attachmentsAccess": "public",
    ;     "attachmentsTokenExpirationSeconds": 64028
    ;   },
    ;   "metadata": {
    ;     "lang": "en-ca"
    ;   }
    ; }

    json.i = CkJsonObject::ckCreate()
    If json.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(json,"displayName","nisi")
    CkJsonObject::ckUpdateInt(json,"settings.conversationRetentionSeconds",84530567)
    CkJsonObject::ckUpdateBool(json,"settings.maskCreditCardNumbers",1)
    CkJsonObject::ckUpdateBool(json,"settings.useAnimalNames",1)
    CkJsonObject::ckUpdateBool(json,"settings.echoPostback",1)
    CkJsonObject::ckUpdateBool(json,"settings.ignoreAutoConversationStart",1)
    CkJsonObject::ckUpdateBool(json,"settings.multiConvoEnabled",1)
    CkJsonObject::ckUpdateString(json,"settings.attachmentsAccess","public")
    CkJsonObject::ckUpdateInt(json,"settings.attachmentsTokenExpirationSeconds",64028)
    CkJsonObject::ckUpdateString(json,"metadata.lang","en-ca")

    CkHttp::ckSetRequestHeader(http,"Content-Type","application/json")

    sbRequestBody.i = CkStringBuilder::ckCreate()
    If sbRequestBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckEmitSb(json,sbRequestBody)

    resp.i = CkHttp::ckPTextSb(http,"PATCH","https://domain.com/",sbRequestBody,"utf-8","application/json",0,0)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(sbRequestBody)
        ProcedureReturn
    EndIf

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodySb(resp,sbResponseBody)

    jResp.i = CkJsonObject::ckCreate()
    If jResp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoadSb(jResp,sbResponseBody)
    CkJsonObject::setCkEmitCompact(jResp, 0)

    Debug "Response Body:"
    Debug CkJsonObject::ckEmit(jResp)

    respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "Response Status Code = " + Str(respStatusCode)
    If respStatusCode >= 400
        Debug "Response Header:"
        Debug CkHttpResponse::ckHeader(resp)
        Debug "Failed."
        CkHttpResponse::ckDispose(resp)

        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(json)
        CkStringBuilder::ckDispose(sbRequestBody)
        CkStringBuilder::ckDispose(sbResponseBody)
        CkJsonObject::ckDispose(jResp)
        ProcedureReturn
    EndIf

    CkHttpResponse::ckDispose(resp)

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

    ; {
    ;   "app": {
    ;     "id": "5d8cff3cd55b040010928b5b",
    ;     "displayName": "utoc",
    ;     "settings": {
    ;       "conversationRetentionSeconds": 35855812,
    ;       "maskCreditCardNumbers": true,
    ;       "useAnimalNames": false,
    ;       "echoPostback": true,
    ;       "ignoreAutoConversationStart": true,
    ;       "multiConvoEnabled": true,
    ;       "attachmentsAccess": "public",
    ;       "attachmentsTokenExpirationSeconds": 64028
    ;     },
    ;     "metadata": {
    ;       "lang": "en-ca"
    ;     }
    ;   }
    ; }

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

    Id.s = CkJsonObject::ckStringOf(jResp,"app.id")
    DisplayName.s = CkJsonObject::ckStringOf(jResp,"app.displayName")
    ConversationRetentionSeconds.i = CkJsonObject::ckIntOf(jResp,"app.settings.conversationRetentionSeconds")
    MaskCreditCardNumbers.i = CkJsonObject::ckBoolOf(jResp,"app.settings.maskCreditCardNumbers")
    UseAnimalNames.i = CkJsonObject::ckBoolOf(jResp,"app.settings.useAnimalNames")
    EchoPostback.i = CkJsonObject::ckBoolOf(jResp,"app.settings.echoPostback")
    IgnoreAutoConversationStart.i = CkJsonObject::ckBoolOf(jResp,"app.settings.ignoreAutoConversationStart")
    MultiConvoEnabled.i = CkJsonObject::ckBoolOf(jResp,"app.settings.multiConvoEnabled")
    AttachmentsAccess.s = CkJsonObject::ckStringOf(jResp,"app.settings.attachmentsAccess")
    AttachmentsTokenExpirationSeconds.i = CkJsonObject::ckIntOf(jResp,"app.settings.attachmentsTokenExpirationSeconds")
    Lang.s = CkJsonObject::ckStringOf(jResp,"app.metadata.lang")


    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(json)
    CkStringBuilder::ckDispose(sbRequestBody)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkJsonObject::ckDispose(jResp)


    ProcedureReturn
EndProcedure

Curl Command

curl -X PATCH
	-u 'username:password'
	-H "Content-Type: application/json"
	-d '{
    "displayName": "nisi",
    "settings": {
        "conversationRetentionSeconds": 84530567,
        "maskCreditCardNumbers": true,
        "useAnimalNames": true,
        "echoPostback": true,
        "ignoreAutoConversationStart": true,
        "multiConvoEnabled": true,
        "attachmentsAccess": "public",
        "attachmentsTokenExpirationSeconds": 64028
    },
    "metadata": {
        "lang": "en-ca"
    }
}'
https://domain.com/

Postman Collection Item JSON

{
  "name": "Update App",
  "_postman_id": "debaf927-71d4-4229-b132-c3115827c4a1",
  "request": {
    "method": "PATCH",
    "header": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"displayName\": \"nisi\",\n    \"settings\": {\n        \"conversationRetentionSeconds\": 84530567,\n        \"maskCreditCardNumbers\": true,\n        \"useAnimalNames\": true,\n        \"echoPostback\": true,\n        \"ignoreAutoConversationStart\": true,\n        \"multiConvoEnabled\": true,\n        \"attachmentsAccess\": \"public\",\n        \"attachmentsTokenExpirationSeconds\": 64028\n    },\n    \"metadata\": {\n        \"lang\": \"en-ca\"\n    }\n}"
    },
    "url": "{{url}}/v2/apps/{{appId}}",
    "description": "Updates an app."
  },
  "response": [
    {
      "id": "3a281976-645d-4f5c-9ae9-3d6adf221d96",
      "name": "App not found",
      "originalRequest": {
        "method": "PATCH",
        "header": [
          {
            "description": {
              "content": "Added as a part of security scheme: bearer",
              "type": "text/plain"
            },
            "key": "Authorization",
            "value": "Bearer <token>"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"displayName\": \"nisi\",\n    \"settings\": {\n        \"conversationRetentionSeconds\": 84530567,\n        \"maskCreditCardNumbers\": true,\n        \"useAnimalNames\": true,\n        \"echoPostback\": true,\n        \"ignoreAutoConversationStart\": true,\n        \"multiConvoEnabled\": true,\n        \"attachmentsAccess\": \"public\",\n        \"attachmentsTokenExpirationSeconds\": 64028\n    },\n    \"metadata\": {\n        \"lang\": \"en-ca\"\n    }\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/v2/apps/:appId",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v2",
            "apps",
            ":appId"
          ],
          "variable": [
            {
              "key": "appId"
            }
          ]
        }
      },
      "status": "Not Found",
      "code": 404,
      "_postman_previewlanguage": "text",
      "header": [
        {
          "key": "Content-Type",
          "value": "text/plain"
        }
      ],
      "cookie": [
      ],
      "body": ""
    },
    {
      "id": "3f6e52ca-11d5-41da-90e7-daff0b71c219",
      "name": "App metadata is limited to 4096 bytes in size.",
      "originalRequest": {
        "method": "PATCH",
        "header": [
          {
            "description": {
              "content": "Added as a part of security scheme: bearer",
              "type": "text/plain"
            },
            "key": "Authorization",
            "value": "Bearer <token>"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"displayName\": \"nisi\",\n    \"settings\": {\n        \"conversationRetentionSeconds\": 84530567,\n        \"maskCreditCardNumbers\": true,\n        \"useAnimalNames\": true,\n        \"echoPostback\": true,\n        \"ignoreAutoConversationStart\": true,\n        \"multiConvoEnabled\": true,\n        \"attachmentsAccess\": \"public\",\n        \"attachmentsTokenExpirationSeconds\": 64028\n    },\n    \"metadata\": {\n        \"lang\": \"en-ca\"\n    }\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/v2/apps/:appId",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v2",
            "apps",
            ":appId"
          ],
          "variable": [
            {
              "key": "appId"
            }
          ]
        }
      },
      "status": "Bad Request",
      "code": 400,
      "_postman_previewlanguage": "text",
      "header": [
        {
          "key": "Content-Type",
          "value": "text/plain"
        }
      ],
      "cookie": [
      ],
      "body": ""
    },
    {
      "id": "c86e51f9-c7d5-43d5-a82e-cd889fe21a5b",
      "name": "Ok",
      "originalRequest": {
        "method": "PATCH",
        "header": [
          {
            "description": {
              "content": "Added as a part of security scheme: bearer",
              "type": "text/plain"
            },
            "key": "Authorization",
            "value": "Bearer <token>"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"displayName\": \"nisi\",\n    \"settings\": {\n        \"conversationRetentionSeconds\": 84530567,\n        \"maskCreditCardNumbers\": true,\n        \"useAnimalNames\": true,\n        \"echoPostback\": true,\n        \"ignoreAutoConversationStart\": true,\n        \"multiConvoEnabled\": true,\n        \"attachmentsAccess\": \"public\",\n        \"attachmentsTokenExpirationSeconds\": 64028\n    },\n    \"metadata\": {\n        \"lang\": \"en-ca\"\n    }\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/v2/apps/:appId",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v2",
            "apps",
            ":appId"
          ],
          "variable": [
            {
              "key": "appId"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"app\": {\n  \"id\": \"5d8cff3cd55b040010928b5b\",\n  \"displayName\": \"utoc\",\n  \"settings\": {\n   \"conversationRetentionSeconds\": 35855812,\n   \"maskCreditCardNumbers\": true,\n   \"useAnimalNames\": false,\n   \"echoPostback\": true,\n   \"ignoreAutoConversationStart\": true,\n   \"multiConvoEnabled\": true,\n   \"attachmentsAccess\": \"public\",\n   \"attachmentsTokenExpirationSeconds\": 64028\n  },\n  \"metadata\": {\n   \"lang\": \"en-ca\"\n  }\n }\n}"
    }
  ]
}