Status anzeigen
Gibt die Details eines einzelnen Status zurück.
Request
GET /api/oauth/v2/resource/todos/statuses/{uuid}
Header
| Header | Wert |
|---|---|
Authorization | Bearer {access_token} |
URL-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
uuid | string | Ja | Eindeutige Status-ID |
Hinweis: Ein gelöschter Status liefert
200 OK, nicht404– das Felddeletedunterscheidet die beiden Fälle.
Response
Erfolg (200 OK)
json
{
"data": {
"id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"name": "Offen",
"type": "open",
"color": "#00adba",
"deleted": false
}
}Response-Felder
| Feld | Typ | Beschreibung |
|---|---|---|
data.id | string (UUID) | Eindeutige Status-ID |
data.name | string | Name des Status (frei konfigurierbar pro Unternehmen) |
data.type | string | Stabile Status-Kategorie: open, in_progress oder done |
data.color | string | Farbe des Status (Hex) |
data.deleted | boolean | true, wenn der Status gelöscht wurde |
Beispiele
bash
curl -X GET "https://my.offisy.at/api/oauth/v2/resource/todos/statuses/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
-H "Authorization: Bearer {access_token}"Parameter
Zuerst Token anfordern
Mögliche Fehler
| Status | Code | Beschreibung |
|---|---|---|
| 401 | invalid_client | Ungültiger oder fehlender Access Token |
| 403 | insufficient_scope | Scope todos nicht vorhanden |
| 404 | not_found | Status nicht gefunden |