> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eorion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取主题名称

> Queries for distinct topic names of external tasks that fulfill given parameters.
Query can be restricted to only tasks with retries left, tasks that are locked, or tasks
that are unlocked. The parameters withLockedTasks and withUnlockedTasks are
exclusive. Setting them both to true will return an empty list.
Providing no parameters will return a list of all distinct topic names with external tasks.



## OpenAPI

````yaml GET /external-task/topic-names
openapi: 3.0.2
info:
  title: ORION Platform REST API
  description: OpenApi Spec for ORION Camunda Platform REST API.
  version: 7.22.6-ee
  license:
    name: Apache License 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: http://{host}:{port}/{contextPath}
    description: The API server for the default process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
  - url: http://{host}:{port}/{contextPath}/engine/{engineName}
    description: The API server for a named process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
      engineName:
        default: default
  - url: '{url}'
    description: The API server with a custom url
    variables:
      url:
        default: ''
security:
  - basicAuth: []
tags:
  - name: Authorization
  - name: Batch
  - name: Condition
  - name: Decision Definition
  - name: Decision Requirements Definition
  - name: Deployment
  - name: Engine
  - name: Event Subscription
  - name: Execution
  - name: External Task
  - name: Filter
  - name: Group
  - name: Historic Activity Instance
  - name: Historic Batch
  - name: Historic Decision Definition
  - name: Historic Decision Instance
  - name: Historic Decision Requirements Definition
  - name: Historic Detail
  - name: Historic External Task Log
  - name: Historic Identity Link Log
  - name: Historic Incident
  - name: Historic Job Log
  - name: Historic Process Definition
  - name: Historic Process Instance
  - name: Historic Task Instance
  - name: Historic User Operation Log
  - name: Historic Variable Instance
  - name: History Cleanup
  - name: Identity
  - name: Incident
  - name: Job
  - name: Job Definition
  - name: Message
  - name: Metrics
  - name: Migration
  - name: Modification
  - name: Process Definition
  - name: Process Instance
  - name: Signal
  - name: Schema Log
  - name: Task
  - name: Task Attachment
  - name: Task Comment
  - name: Task Identity Link
  - name: Task Local Variable
  - name: Task Variable
  - name: Telemetry
  - name: Tenant
  - name: User
  - name: Variable Instance
  - name: Version
externalDocs:
  description: Find out more about ORION Rest API
  url: https://docs.eorion.com
paths:
  /external-task/topic-names:
    get:
      tags:
        - External Task
      summary: Get External Task Topic Names
      description: >-
        Queries for distinct topic names of external tasks that fulfill given
        parameters.

        Query can be restricted to only tasks with retries left, tasks that are
        locked, or tasks

        that are unlocked. The parameters withLockedTasks and withUnlockedTasks
        are

        exclusive. Setting them both to true will return an empty list.

        Providing no parameters will return a list of all distinct topic names
        with external tasks.
      operationId: getTopicNames
      parameters:
        - name: withLockedTasks
          in: query
          schema:
            type: boolean
          description: >-
            Only include external tasks that are currently locked (i.e., they
            have a lock time and it has not expired).

            Value may only be `true`, as `false` matches any external task.
        - name: withUnlockedTasks
          in: query
          schema:
            type: boolean
          description: >-
            Only include external tasks that are currently not locked (i.e.,
            they have no lock or it has expired).

            Value may only be `true`, as `false` matches any external task.
        - name: withRetriesLeft
          in: query
          schema:
            type: boolean
          description: >-
            Only include external tasks that have a positive (> 0) number of
            retries (or `null`). Value may only be

            `true`, as `false` matches any external task.
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
              examples:
                example-1:
                  summary: GET /external-task/topic-names?withLockedTasks
                  value:
                    - topic-a
                    - topic-b
                    - topic-c
          description: Request successful.
        '400':
          content:
            application/json:
              schema: {}
          description: Returned if some of the query parameters are invalid.
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````