Endpoint index

Every endpoint and command in one place: dock's API under /api/dock/v1, the XPLG product's URL API under /logeye, the ingest endpoint and the SDK commands, each with its authentication and the page that documents it.

What you will do: find the call you need and the page that documents it.

dock API — https://dock.xplg.com/api/dock/v1

EndpointPurposeAuthenticationPage
POST /deployments/heartbeatRegister a deployment on first contact; report version and usage meters afterwardsLicense key on first contact, then the deployment token (xdk_…)Heartbeat API (sign in to read)
GET /license/statusPlan versus actual, XMC balance, forecast, alertsDeployment token or a signed-in sessionLicense status API (sign in to read)
GET /pricing/catalogThe price book in force, as the caller may see itOptional sessionOverview and authentication
POST /pricing/quotePrice an offer state with the engineOptional session; channel from the caller's profileOverview and authentication
POST, GET /offers/<id>/attachmentsUpload and list collateral on an offerSessionOverview and authentication
GET /offers/<id>/attachments/<attachmentId>Download one attachmentSessionOverview and authentication
GET /api/dock/health, GET /api/healthcheckHealth summary of the portal; the liveness probeNone for the summary; operator token for the detailOverview and authentication

Usage is read in the workspace and through the license status report — see Usage (sign in to read). Webhooks and API keys with scopes are planned — see Webhooks (sign in to read).

XPLG product URL API — http(s)://<host>:<port>/logeye

Port 30303 or 30443 on V7, the ui role's port or the edge on X8. With security active, every read call signs in with &autoLogin=true&username=<user>&password=<password>.

EndpointPurposePage
GET /view/api/widgetAPI.jsp?widgetId=searchAPI&…Run a search; XML or CSV, pagination, limitsXpoLog search API
GET /view/api/dashboardAPI.jsp?action=export&appName=…&viewName=…A dashboard's latest result as PDFXpoLog search API
GET /search/view/loadSearchModel.jsp?searchQuery=…Open the Search console on a queryXpoLog search API
GET /message/messageJsonApi.jsp?api=collectedDataInfo&…Defined and collected logs per folder or AppTag; uncollected logs with sizesConfiguration API
GET /restapi/folders-and-logs-configuration?sourceQuery=…The Folders and Logs treeConfiguration API
GET /restapi/log-configuration?logPath=…&logName=…One log's definitionConfiguration API
GET /restapi/logs-configuration?sourceQuery=…Many logs' definitions, pipe-delimitedConfiguration API
POST /api/logger.jsp?token=…&hostName=…Ingest a JSON event through an HTTP/S listener; the token authenticatesPortX ingest HTTP API

SDK commands — xpologClient.jar

-xpologURL <url>/logeye -user <user> -password <password> -api <command>; see SDK and CLI reference.

AreaCommands
Settings and securitysettings (ports, Agent Mode, security, time-zone mode, AppTag time zones), securityUsers
AccountsaddSSHAccount, addRemoteXpoLogAccount, addExternalAccount (S3), enableAccount, removeAccount
TasksexecuteTask, executeScanTask, addScanTask, addSyncLogTask
Folders and logsaddLog (files, SSH, Remote XPLG, Windows Event Logs), addFolder, removeMember
Lifecyclelicense, restart, addPatch; the command-line update package applyPatch.sh / applyPatch.bat

Not available yet

  • A token or API key for the product URL API, and its rate limits — pending engineering.
  • Payload limits and throttling of the HTTP/S listener — pending engineering.
  • REST write endpoints on the product — none documented; use the SDK.
  • dock: API keys with scopes, a usage read endpoint and webhooks — planned.

Next: Users and roles (sign in to read)

Source: XPLG wiki, pages 1594753063, 1597014018, 1598685520, 1597014014 (https://xpolog.atlassian.net/wiki/spaces/XPOL/pages/1597014014); dock API routes under apps/web/app/api/dock/v1.

XPLGXPLG
Docs

Search documentation

Search through help articles and documentation

    • Introduction
    • Create your account and workspace
    • Your first deployment in 10 minutes
    • Configure after installation
    • Register a deployment
    • Get an evaluation license
    • Next steps
    • Glossary
    • Overview and authentication
    • Product API and SDK
    • XpoLog search API
    • PortX ingest HTTP API
    • Configuration API
    • SDK and CLI reference
    • Endpoint index
Back to XPLG Dock