Asset anlegen oder aktualisieren
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811922L"
}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811922L" }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '9e2b7c11-1111-2222-3333-444455556666',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811922L'}
})
};
fetch('https://api.docusnap365.com/api/v1/asset', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.docusnap365.com/api/v1/asset",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => '9e2b7c11-1111-2222-3333-444455556666',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811922L'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.docusnap365.com/api/v1/asset"
payload := strings.NewReader("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.docusnap365.com/api/v1/asset")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docusnap365.com/api/v1/asset")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:rest-request-quota-exceeded",
"title": "Request quota exceeded",
"status": 429,
"detail": "The request quota of 10000 requests per period is exhausted until 2026-10-17T09:52:44.0000000+00:00.",
"instance": "/api/v1/assets",
"errorCode": "REST_REQUEST_QUOTA_EXCEEDED",
"errors": [
{
"code": "REST_REQUEST_QUOTA_EXCEEDED",
"data": {
"requestsLimit": 10000,
"requestsUsed": 10000,
"quotaResetAt": "2026-10-17T09:52:44+00:00"
}
}
],
"traceId": "00-…"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}Assets
Asset anlegen oder aktualisieren
Legt ein Asset an – oder aktualisiert es, wenn Docusnap365 es anhand
seiner Identität bereits kennt. Übergeben wird ein AssetBundle:
schemaId bestimmt den Typ, objectData folgt dessen Datendefinition.
Vollständigere Datensätze (completenessLevel) werden nicht durch
weniger vollständige Quellen überschrieben.
Angelegt antwortet die API mit 201, aktualisiert mit 200. Ob das
Asset gespeichert wurde, steht in isSuccess.
Berechtigung: Lesen und Schreiben.
POST
/
asset
Asset anlegen oder aktualisieren
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811922L"
}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"id": "9e2b7c11-1111-2222-3333-444455556666",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811922L" }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '9e2b7c11-1111-2222-3333-444455556666',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811922L'}
})
};
fetch('https://api.docusnap365.com/api/v1/asset', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.docusnap365.com/api/v1/asset",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => '9e2b7c11-1111-2222-3333-444455556666',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811922L'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.docusnap365.com/api/v1/asset"
payload := strings.NewReader("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.docusnap365.com/api/v1/asset")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docusnap365.com/api/v1/asset")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"9e2b7c11-1111-2222-3333-444455556666\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"sourceType\": \"manual\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"idPair": {
"fakeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"dbId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"schemaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"isCreate": true,
"isSuccess": true,
"errorMessage": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:rest-request-quota-exceeded",
"title": "Request quota exceeded",
"status": 429,
"detail": "The request quota of 10000 requests per period is exhausted until 2026-10-17T09:52:44.0000000+00:00.",
"instance": "/api/v1/assets",
"errorCode": "REST_REQUEST_QUOTA_EXCEEDED",
"errors": [
{
"code": "REST_REQUEST_QUOTA_EXCEEDED",
"data": {
"requestsLimit": 10000,
"requestsUsed": 10000,
"quotaResetAt": "2026-10-17T09:52:44+00:00"
}
}
],
"traceId": "00-…"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}{
"type": "urn:ds365:error:unknown-path",
"title": "Unknown field path",
"status": 400,
"detail": "<string>",
"instance": "/api/v1/assets/query",
"errorCode": "UNKNOWN_PATH",
"errors": [
{
"code": "<string>",
"path": "<string>",
"data": {}
}
],
"traceId": "<string>"
}Autorisierungen
API-Schlüssel aus Docusnap365 (Verwaltung › Integrationen › API-Schlüssel). Lesende Endpunkte verlangen den Zugriff Lesen, schreibende Lesen und Schreiben.
Body
application/json
Ein Asset beim Anlegen oder Aktualisieren. Die Feldnamen object und objectData sind Teil der Schnittstelle.
Typ des Assets. Pflicht, auch wenn object.schemaId gesetzt ist.
Frei gewählte Kennung der Anfrage. Wird nicht gespeichert und kommt als idPair.fakeId zurück; ohne Angabe wird eine erzeugt.
Stammangaben eines Assets beim Schreiben.
Show child attributes
Show child attributes
Daten des Typs, nach dessen Datendefinition. Wird ganz ersetzt, nicht ergänzt; weggelassen bleibt es unverändert, {} leert es.
Kurzansicht des Assets.
Show child attributes
Show child attributes
ITAM- und ISMS-Daten des Assets, je Bereich eine Liste.
Show child attributes
Show child attributes
Antwort
Asset aktualisiert.
Ergebnis für ein Bündel.