REST API - Teradata Listener

Teradata® Listener™ User Guide

Product
Teradata Listener
Release Number
2.06
Published
August 2019
Language
English (United States)
Last Update
2019-08-30
dita:mapPath
yng1555531055816.ditamap
dita:ditavalPath
boe1555608925945.ditaval
dita:id
B035-2910
Product Category
Analytical Ecosystem

In Listener, the REST API manages entities, such as sources, users, and targets, and also provides Listener status. The REST API has its own hostname, which an administrator sets when installing Listener.

Base URL

The following is an example hostname path:

https://CLUSTER.DOMAIN/listener/

For specific domain information, contact your administrator.

Authentication

All API requests require a valid Authorization header, except the Login endpoint. The header requires a valid token. To obtain a valid token, send a request to the User Login endpoint. For example, Authorization: Bearer VALID_TOKEN.

Certain endpoints are valid for only the administrator or super user, and require a token obtained during login with the appropriate credentials. Users promoted to administrator after login must obtain a new token to access administrator endpoints. A token is valid for 24 hours from time of issue. When the token expires, delete the cache or stored copy and obtain a new token.

Media Types

The API accepts and returns the application/json media type for all requests. In requests, declare a content-type: application/json header. Requests with a message-body use plain JSON to set or update resource states.

CORS Support

The API supports CORS requests, which allows browsers to call the API directly from other domains.

IDs

All records have an ID in the form of a UUID. Listener UUIDs are version 4 (random). For example, 758fbda4-accc-4f90-8f09-cc0a164c8c28. See https://tools.ietf.org/html/rfc4122 for more information about version 4 UUIDs.

Timestamps

Listener expects all timestamps in the REST API to comply with Date and Time on the Internet: Timestamps in the format of YYYY-MM-DDTHH:MM:SSZ, where all timestamps are in GMT and not localized. For information about supported timestamp formats for ingested messages that are automatically mapped to targets, see Target Mapping.

Error States

Listener uses common HTTP response status codes and provides additional information in the response body, if applicable.