Mehrere Assets anlegen oder aktualisieren
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset/bulk \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"id": "11111111-1111-1111-1111-111111111111",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811922L"
}
},
{
"id": "22222222-2222-2222-2222-222222222222",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV02",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811923M"
}
}
]
'import requests
url = "https://api.docusnap365.com/api/v1/asset/bulk"
payload = [
{
"id": "11111111-1111-1111-1111-111111111111",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811922L" }
},
{
"id": "22222222-2222-2222-2222-222222222222",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV02",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811923M" }
}
]
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: '11111111-1111-1111-1111-111111111111',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811922L'}
},
{
id: '22222222-2222-2222-2222-222222222222',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV02',
schemaId: '00000000-0000-0000-0000-000000000000',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811923M'}
}
])
};
fetch('https://api.docusnap365.com/api/v1/asset/bulk', 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/bulk",
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' => '11111111-1111-1111-1111-111111111111',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811922L'
]
],
[
'id' => '22222222-2222-2222-2222-222222222222',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV02',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811923M'
]
]
]),
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/bulk"
payload := strings.NewReader("[\n {\n \"id\": \"11111111-1111-1111-1111-111111111111\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n },\n {\n \"id\": \"22222222-2222-2222-2222-222222222222\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV02\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811923M\"\n }\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/bulk")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"id\": \"11111111-1111-1111-1111-111111111111\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n },\n {\n \"id\": \"22222222-2222-2222-2222-222222222222\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV02\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811923M\"\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docusnap365.com/api/v1/asset/bulk")
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 {\n \"id\": \"11111111-1111-1111-1111-111111111111\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n },\n {\n \"id\": \"22222222-2222-2222-2222-222222222222\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV02\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811923M\"\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"results": [
{
"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>"
}
],
"successCount": 123,
"failedCount": 123,
"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
Mehrere Assets anlegen oder aktualisieren
Wie POST /asset, für bis zu 100 Assets in einem Aufruf und einer
Transaktion. Die Antwort trägt je Bündel ein Ergebnis in results, in
der Reihenfolge der Anfrage; zugeordnet wird über idPair.fakeId, also
die id des Bündels. isSuccess der Gesamtantwort sagt nur, dass die
Liste verarbeitet wurde – ob jedes Asset gespeichert wurde, steht in
results[].isSuccess und failedCount.
Berechtigung: Lesen und Schreiben.
POST
/
asset
/
bulk
Mehrere Assets anlegen oder aktualisieren
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset/bulk \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"id": "11111111-1111-1111-1111-111111111111",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811922L"
}
},
{
"id": "22222222-2222-2222-2222-222222222222",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV02",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": {
"serialNumber": "CZC811923M"
}
}
]
'import requests
url = "https://api.docusnap365.com/api/v1/asset/bulk"
payload = [
{
"id": "11111111-1111-1111-1111-111111111111",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811922L" }
},
{
"id": "22222222-2222-2222-2222-222222222222",
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV02",
"schemaId": "00000000-0000-0000-0000-000000000000",
"completenessLevel": 80
},
"objectData": { "serialNumber": "CZC811923M" }
}
]
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: '11111111-1111-1111-1111-111111111111',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811922L'}
},
{
id: '22222222-2222-2222-2222-222222222222',
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV02',
schemaId: '00000000-0000-0000-0000-000000000000',
completenessLevel: 80
},
objectData: {serialNumber: 'CZC811923M'}
}
])
};
fetch('https://api.docusnap365.com/api/v1/asset/bulk', 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/bulk",
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' => '11111111-1111-1111-1111-111111111111',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811922L'
]
],
[
'id' => '22222222-2222-2222-2222-222222222222',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV02',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'completenessLevel' => 80
],
'objectData' => [
'serialNumber' => 'CZC811923M'
]
]
]),
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/bulk"
payload := strings.NewReader("[\n {\n \"id\": \"11111111-1111-1111-1111-111111111111\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n },\n {\n \"id\": \"22222222-2222-2222-2222-222222222222\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV02\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811923M\"\n }\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/bulk")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"id\": \"11111111-1111-1111-1111-111111111111\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n },\n {\n \"id\": \"22222222-2222-2222-2222-222222222222\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV02\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811923M\"\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.docusnap365.com/api/v1/asset/bulk")
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 {\n \"id\": \"11111111-1111-1111-1111-111111111111\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV01\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811922L\"\n }\n },\n {\n \"id\": \"22222222-2222-2222-2222-222222222222\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"object\": {\n \"name\": \"SRV02\",\n \"schemaId\": \"00000000-0000-0000-0000-000000000000\",\n \"completenessLevel\": 80\n },\n \"objectData\": {\n \"serialNumber\": \"CZC811923M\"\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"results": [
{
"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>"
}
],
"successCount": 123,
"failedCount": 123,
"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
Maximum array length:
100Typ 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
Liste verarbeitet; Ergebnis je Bündel in results.