Chilkat Online Tools

lianja / Salesforce Platform APIs / Platform Event Schema by Event Name

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")

// Adds the "Authorization: Bearer <access_token>" header.
loHttp.AuthToken = "<access_token>"
loHttp.SetRequestHeader("Content-Type","application/json")

loSbResponseBody = createobject("CkStringBuilder")
llSuccess = loHttp.QuickGetSb("https://domain.com/services/data/v{{version}}/sobjects/:EVENT_NAME/eventSchema",loSbResponseBody)
if (llSuccess = .F.) then
    ? loHttp.LastErrorText
    release loHttp
    release loSbResponseBody
    return
endif

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

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

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

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

// {
//   "name": "Sample__e",
//   "namespace": "com.sforce.eventbus",
//   "type": "expanded-record",
//   "fields": [
//     {
//       "name": "data",
//       "type": {
//         "type": "record",
//         "name": "Data",
//         "namespace": "",
//         "fields": [
//           {
//             "name": "schema",
//             "type": "string"
//           },
//           {
//             "name": "payload",
//             "type": {
//               "type": "record",
//               "name": "Payload",
//               "doc": "",
//               "fields": [
//                 {
//                   "name": "CreatedDate",
//                   "type": "string",
//                   "doc": "CreatedDate:DateTime"
//                 },
//                 {
//                   "name": "CreatedById",
//                   "type": "string",
//                   "doc": "CreatedBy:EntityId"
//                 },
//                 {
//                   "name": "Message__c",
//                   "type": [
//                     "null",
//                     "string"
//                   ],
//                   "doc": "Data:Text:00N4H00000Ecs0G",
//                   "default": null
//                 }
//               ]
//             }
//           },
//           {
//             "name": "event",
//             "type": {
//               "type": "record",
//               "name": "Event",
//               "fields": [
//                 {
//                   "name": "replayId",
//                   "type": "long"
//                 }
//               ]
//             }
//           }
//         ]
//       }
//     },
//     {
//       "name": "channel",
//       "type": "string"
//     }
//   ]
// }

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

lcName = loJResp.StringOf("name")
lcNamespace = loJResp.StringOf("namespace")
lcV_type = loJResp.StringOf("type")
i = 0
lnCount_i = loJResp.SizeOfArray("fields")
do while i < lnCount_i
    loJResp.I = i
    lcName = loJResp.StringOf("fields[i].name")
    lcV_Type = loJResp.StringOf("fields[i].type.type")
    lcName = loJResp.StringOf("fields[i].type.name")
    lcNamespace = loJResp.StringOf("fields[i].type.namespace")
    lcV_type = loJResp.StringOf("fields[i].type")
    j = 0
    lnCount_j = loJResp.SizeOfArray("fields[i].type.fields")
    do while j < lnCount_j
        loJResp.J = j
        lcName = loJResp.StringOf("fields[i].type.fields[j].name")
        lcV_type = loJResp.StringOf("fields[i].type.fields[j].type")
        lcTypeType = loJResp.StringOf("fields[i].type.fields[j].type.type")
        lcTypeName = loJResp.StringOf("fields[i].type.fields[j].type.name")
        lcDoc = loJResp.StringOf("fields[i].type.fields[j].type.doc")
        k = 0
        lnCount_k = loJResp.SizeOfArray("fields[i].type.fields[j].type.fields")
        do while k < lnCount_k
            loJResp.K = k
            lcName = loJResp.StringOf("fields[i].type.fields[j].type.fields[k].name")
            lcV_type = loJResp.StringOf("fields[i].type.fields[j].type.fields[k].type")
            lcDoc = loJResp.StringOf("fields[i].type.fields[j].type.fields[k].doc")
            lcDefault = loJResp.StringOf("fields[i].type.fields[j].type.fields[k].default")

            loJson1 = loJResp.ObjectOf("fields[i].type.fields[j].type.fields[k]")
            lnI1 = 0
            lnCount_i1 = loJson1.SizeOfArray("type")
            do while lnI1 < lnCount_i1
                loJson1.I = lnI1
                lcStrVal = loJson1.StringOf("type[i]")
                lnI1 = lnI1 + 1
            enddo
            release loJson1
            k = k + 1
        enddo
        j = j + 1
    enddo
    i = i + 1
enddo


release loHttp
release loSbResponseBody
release loJResp

Curl Command

curl -X GET
	-H "Authorization: Bearer <access_token>"
	-H "Content-Type: application/json"
https://domain.com/services/data/v{{version}}/sobjects/:EVENT_NAME/eventSchema

Postman Collection Item JSON

{
  "name": "Platform Event Schema by Event Name",
  "request": {
    "method": "GET",
    "header": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "url": {
      "raw": "{{_endpoint}}/services/data/v{{version}}/sobjects/:EVENT_NAME/eventSchema",
      "host": [
        "{{_endpoint}}"
      ],
      "path": [
        "services",
        "data",
        "v{{version}}",
        "sobjects",
        ":EVENT_NAME",
        "eventSchema"
      ],
      "query": [
        {
          "key": "payloadFormat",
          "value": "",
          "description": "(Optional query parameter. Available in API version 43.0 and later.) The format of the returned event schema. This parameter can take one of the following values.\nEXPANDED—The JSON representation of the event schema, which is the default format when payloadFormat is not specified in API version 43.0 and later.\nCOMPACT—A format that adheres to the open-source Apache Avro specification for the record complex type (see Apache Avro Format). Subscribers use the compact schema format to deserialize compact events received in binary form.",
          "disabled": true
        }
      ],
      "variable": [
        {
          "key": "EVENT_NAME",
          "value": "",
          "description": "API Name of the event"
        }
      ]
    },
    "description": "Set, reset, or get information about a user password. This resource is available in REST API version 24.0 and later."
  },
  "response": [
    {
      "name": "Platform Event Schema by Event Name",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{_endpoint}}/services/data/v{{version}}/sobjects/:EVENT_NAME/eventSchema",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "sobjects",
            ":EVENT_NAME",
            "eventSchema"
          ],
          "query": [
            {
              "key": "payloadFormat",
              "value": "",
              "description": "(Optional query parameter. Available in API version 43.0 and later.) The format of the returned event schema. This parameter can take one of the following values.\nEXPANDED—The JSON representation of the event schema, which is the default format when payloadFormat is not specified in API version 43.0 and later.\nCOMPACT—A format that adheres to the open-source Apache Avro specification for the record complex type (see Apache Avro Format). Subscribers use the compact schema format to deserialize compact events received in binary form.",
              "disabled": true
            }
          ],
          "variable": [
            {
              "key": "EVENT_NAME",
              "value": "Sample__e",
              "description": "API Name of the event"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Date",
          "value": "Mon, 03 Jul 2023 13:06:08 GMT"
        },
        {
          "key": "Strict-Transport-Security",
          "value": "max-age=63072000; includeSubDomains"
        },
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "X-Robots-Tag",
          "value": "none"
        },
        {
          "key": "Cache-Control",
          "value": "no-cache,must-revalidate,max-age=0,no-store,private"
        },
        {
          "key": "Sforce-Limit-Info",
          "value": "api-usage=2/15000"
        },
        {
          "key": "Content-Type",
          "value": "application/json;charset=UTF-8"
        },
        {
          "key": "Vary",
          "value": "Accept-Encoding"
        },
        {
          "key": "Content-Encoding",
          "value": "gzip"
        },
        {
          "key": "Transfer-Encoding",
          "value": "chunked"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"name\": \"Sample__e\",\n    \"namespace\": \"com.sforce.eventbus\",\n    \"type\": \"expanded-record\",\n    \"fields\": [\n        {\n            \"name\": \"data\",\n            \"type\": {\n                \"type\": \"record\",\n                \"name\": \"Data\",\n                \"namespace\": \"\",\n                \"fields\": [\n                    {\n                        \"name\": \"schema\",\n                        \"type\": \"string\"\n                    },\n                    {\n                        \"name\": \"payload\",\n                        \"type\": {\n                            \"type\": \"record\",\n                            \"name\": \"Payload\",\n                            \"doc\": \"\",\n                            \"fields\": [\n                                {\n                                    \"name\": \"CreatedDate\",\n                                    \"type\": \"string\",\n                                    \"doc\": \"CreatedDate:DateTime\"\n                                },\n                                {\n                                    \"name\": \"CreatedById\",\n                                    \"type\": \"string\",\n                                    \"doc\": \"CreatedBy:EntityId\"\n                                },\n                                {\n                                    \"name\": \"Message__c\",\n                                    \"type\": [\n                                        \"null\",\n                                        \"string\"\n                                    ],\n                                    \"doc\": \"Data:Text:00N4H00000Ecs0G\",\n                                    \"default\": null\n                                }\n                            ]\n                        }\n                    },\n                    {\n                        \"name\": \"event\",\n                        \"type\": {\n                            \"type\": \"record\",\n                            \"name\": \"Event\",\n                            \"fields\": [\n                                {\n                                    \"name\": \"replayId\",\n                                    \"type\": \"long\"\n                                }\n                            ]\n                        }\n                    }\n                ]\n            }\n        },\n        {\n            \"name\": \"channel\",\n            \"type\": \"string\"\n        }\n    ]\n}"
    }
  ]
}