RTMGETLINK

RTMGETLINK is a utility and API endpoint within Real-Time Messaging (RTM) ecosystems designed to retrieve hyperlinks embedded in messages. It is used to surface URLs for link previews, moderation, analytics, and content filtering across channels and conversations.

RTMGETLINK operates by querying a message or set of messages and returning the unique hyperlinks found within their content. Typical use cases include generating link previews for chat messages, aggregating external references for incident analysis, and enabling automated policy checks on shared URLs. Access is controlled through the RTM authentication and authorization mechanisms of the host platform.

The interface is exposed either as a REST API endpoint or as a library function within the RTM SDKs. Common parameters include channel_id or conversation_id, message_id or date range, maximum number of links to return, include_preview flag, and an authentication token. The endpoint returns a structured payload describing each link, typically including the URL, the display title if available, the host, the timestamp of discovery, and optional metadata such as mime type or content length. Some implementations provide a lightweight preview object with hostname and thumbnail or title.

Example request: GET /rtm/getlink?channel_id=123&message_id=456&limit=5&auth=TOKEN. Example response: { "status":"ok","links":[ {"url":"https://example.com/article","title":"Example Article","host":"example.com","timestamp":1700000000,"preview":{"title":"Example Article","image":"https://example.com/thumb.jpg"} } ] }.

Security and privacy considerations include access control, rate limiting, and redaction of sensitive or internal links. Platforms may also apply content filtering to remove or mask restricted URLs.

See also: RTM API, address resolution, link preview, content moderation.