Spedy Docs

Der Such-Endpunkt ermöglicht es dir, Tickets über alle Boards zu finden, auf die du Zugriff hast. Ergebnisse werden nach Relevanz sortiert und nach deinen Berechtigungen gefiltert.

Tickets suchen

GET /api/v1/search

Rate-Limit: 100 Anfragen pro 60 Sekunden.

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
q	string	Ja	Suchanfrage (1-500 Zeichen)
boardIds	string	Nein	Nach Board-IDs filtern (kommagetrennt)
statusIds	string	Nein	Nach Status-IDs filtern (kommagetrennt)
assigneeId	string	Nein	Nach Verantwortlichem filtern (`"me"` für aktuellen Nutzer)
onlyBlocked	boolean	Nein	Nur Tickets mit BLOCKED-Status
onlyApprovalRequired	boolean	Nein	Nur Tickets im PLANNING (Backlog)-Status
cursor	string	Nein	Paginierungs-Cursor aus vorheriger Antwort
limit	number	Nein	Ergebnisse pro Seite (Standard: 20, max: 50)

Beispiel-Request

GET /api/v1/search?q=login+bug&assigneeId=me&limit=10

Beispiel-Response

{
  "results": [
    {
      "id": "tkt_abc123",
      "displayId": "WEB-42",
      "title": "Login-Seite Styling fixen",
      "description": "Der Login-Button ist falsch ausgerichtet...",
      "board": {
        "id": "brd_abc123",
        "name": "Website Redesign",
        "prefix": "WEB"
      },
      "status": {
        "id": "sts_def456",
        "name": "In Bearbeitung"
      },
      "assignee": {
        "id": "usr_abc123",
        "name": "Alex Smith"
      },
      "priority": "HIGH"
    }
  ],
  "cursor": "eyJzY29yZSI6MC44...",
  "hasMore": true
}

Ergebnisse enthalten nur Tickets von Boards, auf die der aktuelle Nutzer Zugriff hat. Nutzer mit Kunden-Rolle sehen keine Treffer aus geheimen Kommentaren.

Suche

Tickets suchen

Inhaltsverzeichnis