JIRA

In diesem Artikel lernst du, wie du mithilfe der Jira REST API ein Ticket (Issue) in einem Jira-Projekt erstellen kannst. Das ist nützlich für automatisierte Prozesse, Skripte oder externe Systeme, die Tickets in Jira erstellen sollen.

---

🧰 Voraussetzungen

Bevor du ein Ticket über die API erstellen kannst, benötigst du:

• Einen Jira API Token (bei Atlassian Cloud)

• Deine Benutzer-E-Mail-Adresse

• Die URL deiner Jira-Instanz (z. B. https://your-domain.atlassian.net)

• Den Project Key und Issue Type (z. B. TASK, BUG, STORY)

• Ein Tool wie curl, Postman oder ein eigenes Skript (z. B. in Python)

Die Atlassian REST API-Version 3 ist die aktuelle Standardversion für Jira Cloud. API-Dokumentation: developer.atlassian.com/cloud/jira/platform/rest/v3/intro/

---

🔐 Authentifizierung

Für die Atlassian Cloud erfolgt die Authentifizierung über Basic Auth mit einem API Token.

curl -u [email protected]:dein_api_token \
https://your-domain.atlassian.net/rest/api/3/issue

Alternativ kann der Token auch im Header mit Base64-Encodierung übergeben werden:

Authorization: Basic base64encode(email:token)

Verwende möglichst Umgebungsvariablen für Token und Passwörter, um sie nicht im Klartext zu speichern.

🧾 Beispiel: Ticket-Erstellung mit curl

curl --request POST \
  --url https://your-domain.atlassian.net/rest/api/3/issue \
  --header 'Authorization: Basic BASE64_ENCODED_STRING' \
  --header 'Content-Type: application/json' \
  --data '{
    "fields": {
      "project": { "key": "PROJ" },
      "summary": "Beispiel-Ticket via API",
      "description": "Dieses Ticket wurde automatisch erstellt.",
      "issuetype": { "name": "Task" }
    }
  }'

---

🛠 Felder im Detail

Feld	Beschreibung
project.key	Projekt-Schlüssel, z. B. PROJ
summary	Titel oder kurze Zusammenfassung des Tickets
description	Ausführliche Beschreibung
issuetype.name	Typ des Tickets, z. B. Task, Bug, Story

Du kannst weitere optionale Felder wie assignee, priority, labels oder customfield_12345 setzen.

---

✅ Erfolgreiche Antwort

Ein erfolgreicher Request gibt den HTTP-Status 201 (Created) zurück:

{
  "id": "10001",
  "key": "PROJ-123",
  "self": "https://your-domain.atlassian.net/rest/api/3/issue/10001"
}

---

⚠️ Fehlerbehandlung

Statuscode	Bedeutung / Ursache
400 Bad Request	Fehlende oder falsche Felder im Request
401 Unauthorized	API Token oder Authentifizierung fehlerhaft
403 Forbidden	Benutzer hat keine Schreibrechte im Projekt
404 Not Found	Falscher Projekt-Key oder Endpoint

Wenn du häufig 401 oder 403 Fehler erhältst, überprüfe deine API-Berechtigungen in Atlassian. Dein Benutzer muss mindestens "Create Issues" im jeweiligen Projekt dürfen.

---

🧪 Beispiel: Ticket-Erstellung mit Python

import requests
from requests.auth import HTTPBasicAuth
import json

url = "https://your-domain.atlassian.net/rest/api/3/issue"
auth = HTTPBasicAuth("[email protected]", "dein_api_token")

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json"
}

payload = json.dumps({
    "fields": {
        "project": { "key": "PROJ" },
        "summary": "Ticket via Python",
        "description": "Erstellt mit Python und REST API",
        "issuetype": { "name": "Task" }
    }
})

response = requests.post(url, headers=headers, data=payload, auth=auth)
print(response.status_code)
print(response.json())

---

🏁 Ergebnis

Nach erfolgreicher Ausführung wird in Jira ein neues Ticket erstellt. Die API gibt die Ticket-ID, den Issue-Key (z. B. PROJ-123) und die Selbst-URL des Tickets zurück.

Das Ticket kann anschließend über die URL in der Jira-Oberfläche geöffnet oder weiterverarbeitet werden.