Embed findIQ (Standalone)

Learn how to embed or link findIQ in external applications using the standalone view.

Written By Tommy Giesbrecht

Last updated 12 days ago

This article explains how to embed or link findIQ in an external application. Through the standalone view, users can directly access troubleshooting and routines — without the full findIQ interface.

To set this up, you need access to the findIQ app as well as the application where findIQ will be embedded.

Article goal: After reading this article, you will know how to build the standalone URLs for troubleshooting and routines, and how to integrate findIQ into another application via link or iframe.

What is the standalone view?

The standalone view is a reduced version of findIQ that is displayed without navigation and sidebar. This makes it ideal for embedding in other applications via iframe or for direct linking.

There are two standalone views:

  • Troubleshooting — Guides the user through the fault diagnosis of a specific machine.

  • Routine — Starts a specific routine for a machine.

URL structure

Troubleshooting

https://app.findiq.de/standalone/{organisation}/{machine_uid}/diagnose/

Routine

https://app.findiq.de/standalone/{organisation}/{machine_uid}/routine-run/{routine_uid}

Parameters

Parameter

Description

Where to find

{organisation}

The organization name

Visible in the findIQ app URL

{machine_uid}

The unique ID of the machine

Visible in the findIQ app URL

{routine_uid}

The unique ID of the routine

Visible in the findIQ app URL

You can find the parameters in your browser's URL bar when you open the respective machine or routine in the findIQ app.

Set language

You can set the language of the standalone view using the locale query parameter:

https://app.findiq.de/standalone/{organisation}/{machine_uid}/diagnose/?locale=en

Supported values include de, en, fr, among others. The language must be enabled for the organization beforehand. If the parameter is not set or is invalid, the default language of the organization is used.

Authentication

Users must be authenticated to use the standalone view — ideally via SSO.

If users do not have their own findIQ account, you can use share links instead. Share links allow access to a machine without signing in.

→ How to create a share link

Security notice:

  • Even when only the standalone view is opened, the token grants access to the entire machine — including all documents, the heatmap, routines, and the full service log.

  • Share links should therefore not be used statically. Instead, rotate them regularly. Set an expiration date (expires_at) and create new share links periodically via the API.

  • When a machine is used exclusively via share links, the service log entries remain anonymous.

Share link URL structure

Share links use a separate URL structure with a token:

Normal view:

https://app.findiq.de/share?token={token}

Standalone troubleshooting:

https://app.findiq.de/share/diagnose/?token={token}

Standalone routine:

https://app.findiq.de/share/routine-run/?token={token}

You receive the {token} when creating a share link in the findIQ app or via the API.

Create a share link via API

You can also create share links programmatically via the findIQ API. This is especially useful for rotating share links on a regular basis.

Endpoint:

POST /api/auth/{organisation}/ressources/{ressource_id}/sharelinks

Request body:

{ 
   "resource_type": "machines", 
   "expires_at": "2026-04-01T00:00:00Z", 
   "enabled": true, 
   "title": { 
      "type": "plain_text", 
      "en": { 
         "value": "Share link for machine XY",
         "is_auto_translated": false
      }, 
      "de": { 
         "value": "", 
         "is_auto_translated": true 
      } 
   } 
}

Parameters

Field

Type

Description

resource_type

string

Always "machines"

expires_at

datetime / null

Expiration date of the share link (ISO 8601). null for unlimited validity.

enabled

boolean

Whether the share link is active

title

object

Multilingual title of the share link

Response:

The response includes the public_id (UUID) — this is the token you use in the share link URL.

{ 
   "id": "...",
   "public_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
   "owner_name": "my-company",
   "resource_id": "...",
   "resource_type": "machines",
   "expires_at": "2026-04-01T00:00:00Z",
   "enabled": true,
   "title": { ... } 
}

The full share link URL is then:

https://app.findiq.de/share/diagnose/?token=a1b2c3d4-e5f6-7890-abcd-ef1234567890

Integrate findIQ via link

The simplest method is to add the standalone URL directly as a link in your application. The user will then be redirected to the findIQ standalone view in a new tab.

Example:

https://app.findiq.de/standalone/my-company/abc123/diagnose/

Integrate findIQ via iframe

If you want to display findIQ directly within your application, you can embed the standalone URL in an iframe.

Example:

<iframe
  src="https://app.findiq.de/standalone/my-company/abc123/diagnose/"
  width="100%"
  height="800"
  frameborder="0"
  allow="clipboard-write"
></iframe>

The standalone view is specifically optimized for embedding — it contains no navigation or sidebar, so only the relevant content is displayed.

FAQ