curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": {
"sections": {}
},
"facets": {}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": { "sections": {} },
"facets": {}
}
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({
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {},
essentials: {sections: {}},
facets: {}
})
};
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([
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
],
'essentials' => [
'sections' => [
]
],
'facets' => [
]
]),
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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\n}"
response = http.request(request)
puts response.read_body{}"<string>""<string>""<string>"Asset anlegen
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 werden nicht durch weniger vollständige
Quellen überschrieben.
Berechtigung: Schreiben.
curl --request POST \
--url https://api.docusnap365.com/api/v1/asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": {
"sections": {}
},
"facets": {}
}
'import requests
url = "https://api.docusnap365.com/api/v1/asset"
payload = {
"schemaId": "00000000-0000-0000-0000-000000000000",
"object": {
"name": "SRV01",
"schemaId": "00000000-0000-0000-0000-000000000000",
"sourceType": "manual",
"completenessLevel": 80
},
"objectData": {},
"essentials": { "sections": {} },
"facets": {}
}
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({
schemaId: '00000000-0000-0000-0000-000000000000',
object: {
name: 'SRV01',
schemaId: '00000000-0000-0000-0000-000000000000',
sourceType: 'manual',
completenessLevel: 80
},
objectData: {},
essentials: {sections: {}},
facets: {}
})
};
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([
'schemaId' => '00000000-0000-0000-0000-000000000000',
'object' => [
'name' => 'SRV01',
'schemaId' => '00000000-0000-0000-0000-000000000000',
'sourceType' => 'manual',
'completenessLevel' => 80
],
'objectData' => [
],
'essentials' => [
'sections' => [
]
],
'facets' => [
]
]),
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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\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 \"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 \"essentials\": {\n \"sections\": {}\n },\n \"facets\": {}\n}"
response = http.request(request)
puts response.read_body{}"<string>""<string>""<string>"Autorisierungen
API-Schlüssel aus Docusnap365 (Verwaltung › API-Schlüssel). Lesende Endpunkte verlangen die Berechtigung Lesen, schreibende Schreiben.
Body
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.
Korrelations-ID, optional.
Stammdaten eines Assets.
Show child attributes
Show child attributes
Daten des Typs, nach dessen Datendefinition.
Kurzansicht des Assets.
Show child attributes
Show child attributes
ITAM- und ISMS-Daten des Assets, je Bereich eine Liste.
Antwort
Ergebnis des Anlegens oder Aktualisierens.
The response is of type object.