HTTP protocol

The HTTP protocol is used for one-to-one, uni-directional communication. By using the HTTP protocol publishers can publish events at regular intervals.

Click here to view a demo{:target=“_blank”} of using Events with HTTP protocol.

To publish events:

• API CALL:

  POST {baseUrl}/{apiVersion}/producers/namespaces/{namespaceName}/events/{eventName}/{eventVersion}

• PATH PARAMETERS

  • apiversion: Events API version. Include 1.0
  • namespaceName: Provide the name of the namespace to which your event schema is set up. The namespace will be confirmed by the Trimble Cloud Team when they set up the schema for you.
  • eventName: Name of the event. The eventName will be confirmed by the Trimble Cloud Team when they set up the schema for you.
  • eventVersion: Version number of the event set up at the time of configuring event schema. The eventVersion will be confirmed by the Trimble Cloud Team when they set up the schema for you.

• HEADER:

  • Accept: application/json
  • Authorization: Bearer {token}
  • TCP-Request-ID: Used to append a unique ID for the event request. This field is optional. Include Trimble Identity OAuth Bearer token for your application.

• REQUEST BODY:

    {
      "id":"3b706795-eae0-403b-9aba-63a62b6d3219",
      "specversion":"1.0",
      "source":"/tid/<API_ID>",
      "type":"delete.v1",
      "time":"Tue Nov 03 13:00:57 IST 2020",
      "subject":"/tid/UserDelete/SelfInitiate",
      "data":{
        "uuid":"e38d4d02-c52d-4c6d-acfa-de23711f4173"
      }
    }