Assets-API · Uslimato Docs

Basis-URL

https://api.uslimato.com/v1

Benötigte Berechtigung: assets:read (Leseoperationen) oder assets:write (Schreiboperationen).

Assets auflisten

GET /assets

Gibt eine paginierte Liste der Assets Ihrer Organisation zurück.

Query-Parameter:

Parameter	Typ	Beschreibung
`page`	integer	Seitennummer (Standard: 1)
`limit`	integer	Einträge pro Seite (Standard: 20, Max: 100)
`q`	string	Suche nach Name, Asset-Tag oder Seriennummer
`status`	string	Nach Status filtern (z.B. `in_use`)
`asset_type_id`	UUID	Nach Asset-Typ filtern
`kind`	string	Nach Asset-Art filtern: `physical` oder `logical`

Beispiel:

curl "https://api.uslimato.com/v1/assets?kind=physical&status=in_use&limit=10" \
  -H "Authorization: Bearer usl_live_..."

Antwort:

{
  "data": [
    {
      "id": "clx...",
      "asset_tag": "LPC-2026-000042",
      "name": "MacBook Pro 14\" M3",
      "status": "in_use",
      "asset_type_name": "Laptop",
      "asset_kind": "physical",
      "manufacturer": "Apple",
      "model": "MacBook Pro 14\" M3",
      "model_id": "clx...",
      "catalog_manufacturer_name": "Apple",
      "catalog_model_name": "MacBook Pro 14\" M3",
      "serial_number": "C02XY1234",
      "purchase_date": "2024-01-10",
      "purchase_price": 2499.00,
      "warranty_until": "2027-01-10",
      "assigned_to": "user-uuid",
      "notes": null,
      "custom_fields": {},
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-06-01T08:30:00Z"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 10,
    "total_pages": 5
  }
}

Asset-Art-Werte:

Wert	Beschreibung
`physical`	Hardware-Assets (Laptops, Server, Peripheriegeräte usw.)
`logical`	Software- und Lizenz-Assets (SaaS, Abonnements usw.)

Asset abrufen

GET /assets/:id

Gibt ein einzelnes Asset anhand seiner ID zurück, einschließlich aller Katalog-verknüpften Felder.

Antwort: { "data": { ...asset } }

Die Antwort enthält dieselben Felder wie die Listenansicht, zusätzlich catalog_model_name und catalog_manufacturer_name, wenn das Asset mit einem Katalogmodell verknüpft ist.

Asset erstellen

POST /assets

Benötigte Berechtigung: assets:write

Request-Body:

{
  "name": "Dell XPS 15",
  "asset_type_id": "clx...",
  "status": "in_stock",
  "model_id": "clx...",
  "serial_number": "5CG123456",
  "purchase_date": "2024-06-01",
  "purchase_price": 1899.00,
  "notes": "Für neuen Mitarbeiter angeschafft"
}

Felder:

Feld	Pflicht	Beschreibung
`name`	Ja	Anzeigename des Assets
`asset_type_id`	Nein	UUID des Asset-Typs
`status`	Nein	Anfangsstatus (Standard: `in_stock`)
`model_id`	Nein	UUID eines Katalogmodells — befüllt `manufacturer` und `model` automatisch
`manufacturer`	Nein	Herstellername (Freitext, wenn `model_id` nicht gesetzt)
`model`	Nein	Modellname (Freitext, wenn `model_id` nicht gesetzt)
`serial_number`	Nein	Seriennummer des Geräts
`purchase_date`	Nein	ISO 8601-Datumsstring
`purchase_price`	Nein	Dezimalzahl
`warranty_until`	Nein	ISO 8601-Datumsstring
`notes`	Nein	Interne Notizen
`custom_fields`	Nein	Objekt mit benutzerdefinierten Feldwerten

Der Asset-Tag wird automatisch anhand der konfigurierten Mandantenvorlage generiert. Wenn die Vorlage {TYPE_CODE} verwendet, wird das Kürzel des Asset-Typs aus dem Katalog eingesetzt.

Antwort: { "data": { ...created_asset } }

Asset aktualisieren

PATCH /assets/:id

Benötigte Berechtigung: assets:write

Nur die zu ändernden Felder übermitteln (Teilaktualisierung). Unterstützt dieselben Felder wie POST, zusätzlich assigned_to (Benutzer-UUID oder null).

Beispiel:

curl -X PATCH "https://api.uslimato.com/v1/assets/clx..." \
  -H "Authorization: Bearer usl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"status": "in_use", "assigned_to": "user-uuid", "model_id": "katalog-modell-uuid"}'

Asset löschen

DELETE /assets/:id

Benötigte Berechtigung: assets:write

Löscht das Asset dauerhaft. Empfohlen ist stattdessen die Statusänderung auf scrapped, um den Audit-Verlauf zu erhalten.

Antwort: { "message": "Asset deleted." }

Asset-Status

Wert	Bezeichnung
`in_stock`	Im Bestand
`preparing`	In Vorbereitung
`in_use`	In Benutzung
`in_service`	Im Service
`returned`	Zurückgegeben
`scrapped`	Verschrottet