If you need to implement a program in order to access some Twitter APIs using the application-only authentication, the following will explain how to do it. Also the example shows how to read some Tweets once connected. You can find Twitter's documentation at the address: https://developer.twitter.com/en/docs/basics/authentication/overview/application-only.

In order to use this kind of authentication you need to have a configured application on Twitter to get a "Consumer Key" (or "API Key") and a "Consumer secret" (or "API Secret").

These two strings are basically equivalent to a login name and a password to be used in an HTTP Basic Authentication.

Your COBOL program will define at least 2 classes: the class for doing an HTTP connection and the class for passing parameters in the HTTP requests, e.g.:

So the first HTTP request will be a typical POST request using the Basic authentication and supplying the parameter "grant_type" whose value will be "client_credentials".

The response to this request will be a JSON-encoded payload: if the response code is different from 200 (OK), the JSON payload will be something like the following:

while if the response will be 200 the JSON payload will be something like this:

In order to get the data from this payload you can define the following structure in isCOBOL:

So you can get the two strings with something like:

According to the official documentation, you must verify that the token type is "bearer" and then you can use the access token to call the APIs you need, allowed by this authentication method.

For example, you can implement the "user_timeline" API: in order to do this, we need to use the access token as "bearer" instead of the login/password used previously. The new method setAuth (ICobolVar a) of HTTPClient do exactly this. You can also pass all the supported parameters. See https://developer.twitter.com/en/docs/tweets/timelines/api-reference/get-statuses-user_timeline for the full documentation. E.g.:

In this case you perform the GET request according to the official documentation. This request will return two different JSON payloads depending on the success of the call, but, differently from what happened in the previous API, it seems that the response code is 200 in any case. This means that you cannot know which isCOBOL structure you must use in order to get the data from the payload.

The two formats returned by the above API are very different: when there is an error the format is very similar to the one already seen above when the authorization fails. If the operation return successfully, however, the payload will be an array of objects, whose length depends on the "count" parameter, each one including about 100 fields (see https://developer.twitter.com/en/docs/tweets/timelines/api-reference/get-statuses-user_timeline for a complete description).

In our example we are interested only in few fields, so we have defined a structure like the following:

The first 03 item is the data we need for our application.

This is the full program:

where "api_key" and "api_secret" are the "Consumer Key" (or "API Key") and a "Consumer secret" (or "API Secret") are retrieved from the configuration file.