ArtenFinder Web Service API Version 2.0
Dokumentation der ArtenFinder REST Web-Service API Version 2.0
Version: 2.0.40
Copyright: © 2014 Struktur- und Genehmigungsdirektion Nord Rheinland-Pfalz
Aktualisierungsdatum: 30.09.2024
Verzeichnis
- Allgemeines
- REST Web-Services
- Änderungsprotokolle der Web Service API
- Änderungsprotokoll vom 03.02.2014, Version 2.0.6
- Änderungsprotokoll vom 06.02.2014, Version 2.0.7
- Änderungsprotokoll vom 07.02.2014, Version 2.0.8
- Änderungsprotokoll vom 24.04.2014, Version 2.0.9
- Änderungsprotokoll vom 29.04.2014, Version 2.0.10
- Änderungsprotokoll vom 05.06.2014, Version 2.0.11
- Änderungsprotokoll vom 18.08.2014, Version 2.0.12
- Änderungsprotokoll vom 22.09.2014, Version 2.0.13
- Änderungsprotokoll vom 22.09.2014, Version 2.0.14
- Änderungsprotokoll vom 01.10.2014, Version 2.0.15
- Änderungsprotokoll vom 20.02.2015, Version 2.0.16
- Änderungsprotokoll vom 07.12.2016, Version 2.0.17
- Änderungsprotokoll vom 23.05.2017, Version 2.0.18
- Änderungsprotokoll vom 01.06.2017, Version 2.0.19
- Änderungsprotokoll vom 24.08.2017, Version 2.0.20
- Änderungsprotokoll vom 20.11.2018, Version 2.0.21
- Änderungsprotokoll vom 26.11.2018, Version 2.0.22
- Änderungsprotokoll vom 16.08.2019, Version 2.0.23
- Änderungsprotokoll vom 23.08.2019, Version 2.0.24
- Änderungsprotokoll vom 28.02.2020, Version 2.0.25
- Änderungsprotokoll vom 28.02.2020, Version 2.0.26
- Änderungsprotokoll vom 02.07.2020, Version 2.0.27
- Änderungsprotokoll vom 02.07.2020, Version 2.0.28
- Änderungsprotokoll vom 03.08.2020, Version 2.0.29
- Änderungsprotokoll vom 19.09.2020, Version 2.0.30
- Änderungsprotokoll vom 23.02.2021, Version 2.0.31
- Änderungsprotokoll vom 26.03.2021, Version 2.0.32
- Änderungsprotokoll vom 26.03.2021, Version 2.0.33
- Änderungsprotokoll vom 09.04.2021, Version 2.0.34
- Änderungsprotokoll vom 27.07.2021, Version 2.0.35
- Änderungsprotokoll vom 02.08.2021, Version 2.0.36
- Änderungsprotokoll vom 10.03.2023, Version 2.0.37
- Änderungsprotokoll vom 10.04.2024, Version 2.0.38
- Änderungsprotokoll vom 12.06.2024, Version 2.0.39
- Änderungsprotokoll vom 30.09.2024, Version 2.0.40
- FAQ
- Impressum
Allgemeines
Zeichenkodierung
Die REST-Schnittstelle antwortet in der Kodierung UTF-8.
Formate
Die REST-Schnittstelle beantwortet Anfragen in den Formaten XML, JSON oder JavaScript.
XML
Eine Antwort in XML kann für jede Anfrage an die REST-Schnittstelle über den URL-Parameter format und die Wertzuweisung xml angefordert werden. Geantwortet wird hieraufhin mit Content-Type: text/xml; charset=utf-8
.
JSON
JSON ist das Standardausgabeformat der REST-Schnittstelle. Standardgemäss antwortet die Schnittstelle in Content-Type: application/json; charset=utf-8
.
JavaScript
Die REST-Schnittstelle gibt für in JSON with padding (JSONP) angeforderte Antworten JavaScript zurück. Die Anforderung erfolgt über den URL-Parameter callback in dem der gewünschte Methodenname eingetragen wird. Beantwortet wird diese Anfrage mit Content-Type: application/javascript; charset=utf-8
.
Neben Cross-Domain GET-Anfragen mittels JSONP bietet die REST-Schnittstelle für Schreiboperationen in JavaScript für die Methoden POST, PUT und DELETE Cross-Origin Resource Sharing (CORS) an. Beispiele zur Anwendung von Cross-Domain Schreiboperationen in JavaScript sind detailliert im jeweiligen Abschnitt dokumentiert.
Authentifizierung für zugriffsbeschränkte Anfragen
Die Nutzer-Authentisierung der REST-Schnittstelle erfolgt einheitlich für die Methoden GET, POST, PUT und DELETE. Zusätzlich zur jeweiligen Anfrage sind hierfür zwei Header erforderlich, X-Auth-User und X-Auth-Token, Platzhalter für den Loginnamen des Nutzers und den Zugriffsschlüssel.
Der Zugriffsschlüssel zur Verwendung in X-Auth-Token wird bei erfolgreicher Anmeldung des Nutzers übergeben (s. Nutzer anmelden).
Vorlage: Authentifizierte GET Anfrage HTTP GET JSON Mit Authentifizierung
GET /api/v2/sichtbeobachtungen HTTP/1.1
Host: berlin.artenfinder.net
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Eine authentifizierte Anfrage mittels cURL
Beispiel: Authentifizierte GET Anfrage über Kommandozeile mittels cURL cURL HTTP GET JSON Mit Authentifizierung
curl -H "X-Auth-User: jdoe" -H "X-Auth-Token: pndVpURTRaREkz" -X GET https://berlin.artenfinder.net/api/v2/sichtbeobachtungen
Eine authentifizierte Anfrage in JavaScript
Beispiel: Authentifizierte GET Anfrage in JavaScript / jQuery jQuery HTTP GET JavaScript (JSONP) Mit Authentifizierung
jQuery.ajax({type: 'GET', url: 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen',
beforeSend: function(xhr, settings) {
xhr.setRequestHeader('X-Auth-User', 'jdoe');
xhr.setRequestHeader('X-Auth-Token', 'pndVpURTRaREkz');
}, dataType: 'jsonp', success: function(contents) { … }});
Eine authentifizierte Anfrage in Python
Beispiel: Authentifizierte GET Anfrage in Python Python HTTP GET JSON Mit Authentifizierung
import urllib2
request = urllib2.Request("https://berlin.artenfinder.net/api/v2/sichtbeobachtungen", headers={"X-Auth-User" : "jdoe", "X-Auth-Token": "pndVpURTRaREkz"})
contents = urllib2.urlopen(request).read()
Eine authentifizierte Anfrage in PHP
Beispiel: Authentifizierte GET Anfrage in PHP PHP HTTP GET JSON Mit Authentifizierung
$contents = file_get_contents( 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen', false, stream_context_create( array( 'http' => array(
'method' => 'GET',
'header' => Array('X-Auth-User: jdoe', 'X-Auth-Token: pndVpURTRaREkz')
))));
Eine authentifizierte Anfrage in ASP.NET
Beispiel: Authentifizierte GET Anfrage in ASP.NET ASP.NET HTTP GET JSON Mit Authentifizierung
System.Net.WebClient request = new System.Net.WebClient();
request.Headers.Add( "X-Auth-User", "jdoe" );
request.Headers.Add( "X-Auth-Token", "pndVpURTRaREkz" );
var contents = request.DownloadString( "https://berlin.artenfinder.net/api/v2/sichtbeobachtungen" );
REST Web-Services
Zum Nutzer
Anmelden
Schnittstelle: https://berlin.artenfinder.net/api/v2/login
Methoden:
Parameter:
- Pflichtparameter
- loginname
- Loginname des Nutzers in Klartext
- Datentyp: String
- password (SHA-1 des Passwortes)
- Passwort des Nutzers gehasht im "Secure hash algorithm" (SHA-1)
- Datentyp: String
- optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
Antwort (bei erfolgreicher Anmeldung):
- name
- Vor- und Nachname
- Datentyp: String
- id
- Eindeutige Benutzer-ID
- Datentyp: Integer
- token
- Zugriffsschlüssel für Authentifizierung
- Datentyp: String
- loginname
- Loginname des Nutzers in Klartext
- Datentyp: String
Antwort (bei falscher Anmeldung):
Leere Antwort mit
HTTP/1.1 200 OK
Antwort (bei fehlenden Parametern): Hinweisende Antwort mit
HTTP/1.1 400 Bad Request
Beispiel: Erfolgreiche Login-Anfrage HTTP GET JSON
https://berlin.artenfinder.net/api/v2/login?loginname=mustermann&password=d68d278ebf67570386e222f79a65bd1a5979f61bf
Antwort
{"name":"Hans Mustermann","id":3,"token":"pndVpURTRaREkz","loginname":"mustermann"}
Beispiel: Erfolgreiche Login-Anfrage beantwortet in XML HTTP GET XML
https://berlin.artenfinder.net/api/v2/login?format=xml&loginname=mustermann&password=d68d278ebf67570386e222f79a65bd1a5979f61bf
Antwort
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result><name>Hans Mustermann</name><id>3</id><token>pndVpURTRaREkz</token><loginname>mustermann</loginname></result>
Beispiel: Login-Anfrage in JavaScript / jQuery jQuery HTTP GET JavaScript (JSONP)
jQuery.ajax({ statusCode : { 200 : function( data ) { if( data && data.id ) { /* ... Login OK ... */ } else { /* ... Login fehlerhaft ... */ }}}, type: 'GET', url: 'https://berlin.artenfinder.net/api/v2/login?', data : { loginname: 'mustermann', password: 'd68d278ebf67570386e222f79a65bd1a5979f61bf' }, dataType : 'jsonp', error : function( xmlhttp ){ /* ... Verbindung fehlerhaft ... */ }});
Zur geforderten Kodierung eines Passwortes in SHA-1 mittels JavaScript bieten sich die "JavaScript implementations of standard and secure cryptographic algorithms" an. (Linkverweis: https://code.google.com/p/crypto-js/#SHA-1)
Registrieren/Anlegen
Schnittstelle: https://berlin.artenfinder.net/api/v2/register
Hinweise zur Registrierung
Nach erfolgreicher Anfrage zur Registrierung wird eine E-Mail entsprechend der vorhandenen Drupal 7 Registrierungsrichtlinie an die angegebene E-Mail Adresse versand.
Methoden:
Parameter:
- Pflichtparameter
- loginname
- Loginname des neu zu registrierenden Nutzers
- Datentyp: String
- Zeichenbeschränkung: Leerzeichen sind erlaubt; Interpunktion ist mit der Ausnahme von Punkt
.
, Bindestrich -
, Apostroph '
und Unterstrich _
nicht erlaubt.
- email
- E-Mail Adresse des neu zu registrierenden Nutzers
- Datentyp: String
- vorname
- Vorname des neu zu registrierenden Nutzers
- Datentyp: String
- nachname
- Nachname des neu zu registrierenden Nutzers
- Datentyp: String
- optionale Parameter
- anonymisiert
- Nutzerkonteneinstellung zur Anonymisierung
- Datentyp: Integer
- Auswahlwerte:
- 0
- Nutzerkonto ist nicht anonymisiert
- 1
- Nutzerkonto ist anonymisiert
- portal-name
- Optionale Angabe des Namens der zur Registrierung anfragenden Seite (z.B. Kampagnen-Portal "Wo ist Milan")
- Datentyp: String
- portal-url
- Optionale Angabe der URL der zur Registrierung anfragenden Seite (z.B. Kampagnen-Portal "www.wo-ist-milan.de")
- Datentyp: String
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
Antwort (bei erfolgreicher Registrierungsanfrage):
- login
- Loginname
- Datentyp: String
- name
- Vor- und Nachname
- Datentyp: String
- email
- E-Mail Adresse
- Datentyp: String
Antwort (bei fehlenden oder fehlerhaften Parametern): Hinweisende Antwort mit
HTTP/1.1 400 Bad Request
Beispiel: Erfolgreiche Registrierungs-Anfrage HTTP GET JSON
https://berlin.artenfinder.net/api/v2/register?loginname=mustermann&email=hans.mustermann@xyz.de&vorname=Hansn&nachname=Mustermann
Antwort
{"login":"mustermann","name":"Hans Mustermann","email":"hans.mustermann@xyz.de"}
Ändern der Nutzerinformationen
Schnittstelle: https://berlin.artenfinder.net/api/v2/nutzer/:id
Rechteverwaltung
Die Berechtigung zur Bearbeitung erhält der Besitzer des Nutzerkontos sowie authentisierte Nutzer der Rolle Administrator.
Einige Änderungen von Nutzerinformationen (Vor-, Nachname und Rollenzuordnungen) sind allein Nutzern der Rolle Administrator vorbehalten.
Methoden:
- PUT Authentifizierung erforderlich
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
optionale Datenfelder:
- email
- E-Mail Adresse des Nutzerkontos
- Datentyp: String
- passwort (SHA-1 des neuen Passwortes)
- Neues Passwort des Nutzerkontos gehasht im "Secure hash algorithm" (SHA-1)
- Datentyp: String
- nachname Administratorenrolle erforderlich
- Nachname des Nutzers
- Datentyp: String
- vorname Administratorenrolle erforderlich
- Vorname des Nutzes
- Datentyp: String
- anonymisiert Administratorenrolle erforderlich
- Nutzerkonteneinstellung zur Anonymisierung
- Datentyp: Integer
- Auswahlwerte:
- 0
- Nutzerkonto wird veröffentlicht
- 1
- Nutzerkonto wird anonymisiert
- status Administratorenrolle erforderlich
- Status des Nutzerkontos
- Datentyp: Integer
- Auswahlwerte:
- 0
- Nutzerkonto wird gesperrt
- 1
- Nutzerkonto wird aktiviert
- rollen Administratorenrolle erforderlich
- Zugewiesene Nutzerrollen
- Datentyp: String
- Auswahlwerte: expert, administrator
- artengruppenbeschraenkung Administratorenrolle erforderlich
- Auf Artengruppen über die eindeutige Artengruppen-ID referenzierte Expertenbeschränkung des Nutzerkontos
- Datentyp: String
- Beispielwert für eine Expertenbeschränkung auf die Artengrupppen Vögel und Säugetiere:
346562,342776
optionale Parameter:
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
Antwort (bei erfolgreicher Bearbeitung):
HTTP/1.1 200 OK
Antwort (bei zwar authentisierter jedoch unberechtigter Anfrage):
HTTP/1.1 403 Forbidden
Vorlage: Authentifizierte PUT Anfrage HTTP PUT Mit Authentifizierung
PUT /api/v2/nutzer/325627 HTTP/1.1
Host: berlin.artenfinder.net
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Content-Type: multipart/form-data; charset=utf-8; boundary=--------------------31063722920652
------------------------------31063722920652
Content-Disposition: form-data; name="email"
jdoe2014@provider.de
-----------------------------31063722920652--
Einige Umgebungen unterstützen u.U. die REST Methode PUT nicht, oder die Umsetzung ist schwierig. Hierfür erlaubt der Webservice Methoden im Header zu überladen. Verwenden Sie in einem solchen Fall POST und übergeben im Header in X-HTTP-Method-Override die gewünschte Methode PUT.
Vorlage: Authentifizierte PUT Anfrage über POST senden HTTP PUT (OVERRIDING POST) Mit Authentifizierung
POST /api/v2/sichtbeobachtungen/34435 HTTP/1.1
Host: berlin.artenfinder.net
X-HTTP-Method-Override: PUT
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Content-Type: multipart/form-data; charset=utf-8; boundary=--------------------31063722920652
------------------------------31063722920652
Content-Disposition: form-data; name="email"
jdoe2014@provider.de
-----------------------------31063722920652--
Eine authentifizierte Bearbeitung eines Nutzerkontos mittels cURL
Beispiel: Authentifizierte Bearbeitung eines Nutzerkontos in der Kommandozeile mittels cURL cURL HTTP PUT Mit Authentifizierung
curl -i -H "X-Auth-User: jdoe" -H "X-Auth-Token: pndVpURTRaREkz" -H "Content-Type: multipart/form-data; charset=utf-8" -F "email=jdoe2014@provider.de" -X PUT https://berlin.artenfinder.net/api/v2/nutzer/124561
Eine authentifizierte Bearbeitung eines Nutzerkontos in PHP
Beispiel: Authentifizierte PUT Bearbeitung eines Nutzerkontos in PHP PHP HTTP PUT Mit Authentifizierung
define('MULTIPART_BOUNDARY', '--------------------------'.microtime(true));
$contents = file_get_contents( 'https://berlin.artenfinder.net/api/v2/nutzer/34435', false, stream_context_create( array( 'http' => array(
'method' => 'PUT',
'header' => Array('X-Auth-User: jdoe', 'X-Auth-Token: pndVpURTRaREkz', 'Content-Type: multipart/form-data; charset=utf-8; boundary='.MULTIPART_BOUNDARY),
'content' =>
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="email"'."\r\n\r\n".
'jdoe2014@provider.de'."\r\n".
'--'.MULTIPART_BOUNDARY.'--'."\r\n"
))));
Eine authentifizierte Bearbeitung eines Nutzerkontos in JavaScript
Beispiel: Authentifizierte PUT Bearbeitung eines Nutzerkontos in JavaScript / jQuery JavaScript HTTP PUT (OVERRIDING POST) Mit Authentifizierung
var data = new FormData();
data.append( 'email', 'jdoe2014@provider.de' );
jQuery.ajax({type: 'POST', crossDomain: true, url: 'https://berlin.artenfinder.net/api/v2/nutzer/34435', cache: false, contentType: false, processData: false, data: data,
beforeSend: function(xhr, settings) {
xhr.setRequestHeader('X-HTTP-Method-Override', 'PUT');
xhr.setRequestHeader('X-Auth-User', 'jdoe');
xhr.setRequestHeader('X-Auth-Token', 'pndVpURTRaREkz');
}, dataType: 'json', success: function(contents) { … }});
Löschen von Nutzerinformationen
Schnittstellendefinition unter Zum Nutzer > Ändern der Nutzerinformationen.
Rechteverwaltung
Die Berechtigung zum Löschen von Benutzerinformationen erhält der Besitzer des Nutzerkontos sowie authentisierte Nutzer der Rolle Administrator.
Einige Löschungen von Nutzerinformationen (Vor-, Nachname und Rollenzuordnungen) sind allein Nutzern der Rolle Administrator vorbehalten.
Hinweise zum Löschen von Nutzerinformationen
Zum Löschen von Benutzerinformationen das entsprechende Datenfeld analog zu „Ändern der Nutzerinformationen” mit leerem Inhalt übertragen.
Abfragen (Details eines Nutzerkontos, inklusive Berechtigungen)
Schnittstelle: https://berlin.artenfinder.net/api/v2/nutzer/:id
Rechteverwaltung
Neben der Erlaubnis das eigene Nutzerkonto abzurufen erhalten ausschliesslich authentisierte Nutzer der Rolle Administrator Einsicht in fremde Nutzerprofile.
Methoden:
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
Antwort:
- result
- row (XML) / Array (JSON)
- id
- Eindeutige Nutzer-ID
- Datentyp: Integer
- loginname
- Loginname des Nutzerkontos
- Datentyp: String
- email
- E-Mail Adresse des Nutzerkontos
- Datentyp: String
- nachname
- Nachname des Nutzers
- Datentyp: String
- vorname
- Vorname des Nutzes
- Datentyp: String
- anonymisiert
- Nutzerkonteneinstellung zur Anonymisierung
- Datentyp: Integer
- Auswahlwerte:
- 0
- Nutzerkonto ist nicht anonymisiert
- 1
- Nutzerkonto ist anonymisiert
- status
- Status des Nutzerkontos
- Datentyp: Integer
- Auswahlwerte:
- 0
- 1
- Nutzerkonto ist aktiviert
- rollen
- Zugewiesene Nutzerrollen
- Datentyp: Liste (XML) / Array (JSON)
- Auswahlwerte:
- artengruppenbeschraenkung
- Auflistung der Expertenbeschränkung des Nutzerkontos auf Artengruppen referenziert über die eindeutige Artengruppen-ID
- Datentyp: Liste (XML) / Array (JSON)
Nach Nutzern suchen
Schnittstelle: https://berlin.artenfinder.net/api/v2/nutzer
Rechteverwaltung
Die Suchantwort unterliegt der Rechteverwaltung. Ausschliesslich authentisierte Nutzer der Rolle Administrator erhalten Einsicht in fremde Nutzerprofile.
Methoden:
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
Parameter:
- optionale Such-/Filterparameter
- email
- Filter nach hinterlegter E-Mail Adresse
- Datentyp: String
- name_regexp_ci
- Auswahl von Nutzern nach regulärem Ausdruck (POSIX, Case Insensitive) referenziert sowohl auf den Vor- als auch Nachnamen
- Datentyp: String
- status
- Auswahl nach aktuellem Status des Nutzerkontos
- Datentyp: Integer
- Auswahlwerte:
- 0
- 1
- Nutzerkonto ist aktiviert
- optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- limit
- Begrenzung der Ergebnisliste
- Datentyp: Integer
- Standardwert: 100
- Gültiger Wertebereich: 1 - 1000
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
Antwort:
- result
- row (XML) / Array (JSON)
- id
- Eindeutige Nutzer-ID
- Datentyp: Integer
- loginname
- Loginname des Nutzerkontos
- Datentyp: String
- email
- E-Mail Adresse des Nutzerkontos
- Datentyp: String
- nachname
- Nachname des Nutzers
- Datentyp: String
- vorname
- Vorname des Nutzes
- Datentyp: String
- anonymisiert
- Nutzerkonteneinstellung zur Anonymisierung
- Datentyp: Integer
- Auswahlwerte:
- 0
- Nutzerkonto ist nicht anonymisiert
- 1
- Nutzerkonto ist anonymisiert
- status
- Status der Nutzerkontos
- Datentyp: Integer
- Auswahlwerte:
- 0
- 1
- Nutzerkonto ist aktiviert
- next
- Ist die erhaltene Antwort limitiert, wird in next eine URL auf die fortführende Ergebnisliste/Seite aufgezeigt.
- Datentyp: String
Zu Arten
Abfragen (der Artengruppenliste)
Schnittstelle: https://berlin.artenfinder.net/api/v2/artengruppen
Methoden:
Parameter:
- optionale Such-/Filterparameter
- is_animal
- Filter ob Pflanzen- oder Tiergruppe
- Datentyp: Boolean
- optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- limit
- Begrenzung der Ergebnisliste
- Datentyp: Integer
- Standardwert: 100
- Gültiger Wertebereich: 1 - 1000
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
- Bsp. für eine Restriktion auf den deutschen Artengruppenamen:
https://berlin.artenfinder.net/api/v2/artengruppen?format=xml&restrict=id,name_deutsch
Link
Antwort:
- result
- row (XML) / Array (JSON)
- id
- Eindeutige Artengruppen-ID
- Datentyp: Integer
- name_deutsch
- Deutscher Name der Artengruppe
- Datentyp: String
- is_animal
- Pflanzen- oder Tiergruppe
- Datentyp: Boolean
- next
- Ist die erhaltene Antwort limitiert, wird in next eine URL auf die fortführende Ergebnisliste/Seite aufgezeigt.
- Datentyp: String
Beispiel: Abfrage aller Artengruppen HTTP GET JSON
https://berlin.artenfinder.net/api/v2/artengruppen
Link
Antwort
{"result":[{"id":349200,"name_deutsch":"Zikaden","is_animal":true},…]}
Beispiel: Abfrage aller Artengruppen beantwortet in XML HTTP GET XML
https://berlin.artenfinder.net/api/v2/artengruppen?format=xml
Link
Antwort
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xml><result><row><id>347838</id><name_deutsch>Zikaden</name_deutsch><is_animal>TRUE</is_animal></row>…</result></xml>
Abfragen (der Artenliste)
Schnittstelle: https://berlin.artenfinder.net/api/v2/arten
Methoden:
Parameter:
- optionale Such-/Filterparameter
- is_animal
- Filter ob Pflanze- oder Tier
- Datentyp: Boolean
- artengruppe
- Filter nach deutschem Namen der Artengruppen
- Datentyp: String
- gid
- Auswahl über die eindeutige Artengruppen-ID
- Datentyp: Integer
- name_regexp_ci
- Auswahl von Arten nach regulärem Ausdruck (POSIX, Case Insensitive) referenziert sowohl auf den deutschen als auch wissenschaftlichen Artnamen (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Artnamen des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- limit
- Begrenzung der Ergebnisliste
- Datentyp: Integer
- Standardwert: 100
- Gültiger Wertebereich: 1 - 1000
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
- Bsp. für eine Restriktion auf den deutschen Artnamen:
https://berlin.artenfinder.net/api/v2/arten?format=xml&restrict=id,name_deutsch
Link
Antwort:
- result
- row (XML) / Array (JSON)
- id
- eu_guid
- Eindeutige EU Art-ID
- Datentyp: String
- gid
- Eindeutige Artengruppen-ID
- Datentyp: Integer
- art_id
- Mandantenspezifische Art-ID (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Art-ID des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- name_wissenschaftlich
- Wissenschaftlicher Artname (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo wissenschaftlicher Artname des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- name_deutsch
- Deutscher Artname (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo deutscher Artname des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- sensibel
- Mandantenspezifisch naturschutzfachlich sensible Art (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. Artdefinition des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: Boolean
- artengruppe
- Deutscher Artengruppenname
- Datentyp: String
- is_animal
- Pflanze oder Tier
- Datentyp: Boolean
- next
- Ist die erhaltene Antwort limitiert, wird in next eine URL auf die fortführende Ergebnisliste/Seite aufgezeigt.
- Datentyp: String
Beispiel: Abfrage aller Arten HTTP GET JSON
https://berlin.artenfinder.net/api/v2/arten
Link
Antwort
{"result":[{"id":342930,"eu_guid":"urn:lsid:faunaeur.org:taxname:440164","name_wissenschaftlich":"Synanthedon loranthi","name_deutsch":"Mistel-Glasflügler","artengruppe":"Baeren- Spinner","gid":342930,"is_animal":true},…]}
Beispiel: Abfrage aller Arten beantwortet in XML HTTP GET XML
https://berlin.artenfinder.net/api/v2/arten?format=xml
Link
Antwort
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xml><result><row><id>342930</id><eu_guid>urn:lsid:faunaeur.org:taxname:440164</eu_guid><name_wissenschaftlich>Synanthedon loranthi</name_wissenschaftlich><name_deutsch>Mistel-Glasflügler</name_deutsch><artengruppe>Baeren- Spinner</artengruppe><gid>342930</gid><is_animal>TRUE</is_animal></row>…</result></xml>
Abfragen (Artenliste zur Artengruppe)
Schnittstellendefinition unter Zu Arten > Abfragen (der Artenliste).
Beispiel: Liste der Arten zur Artengruppe mit Namen Vögel HTTP GET JSON
https://berlin.artenfinder.net/api/v2/arten?artengruppe=Vögel
Link
Antwort
{"result":[{"id":710277,"eu_guid":"urn:lsid:faunaeur.org:taxname:97372","name_wissenschaftlich":"Phylloscopus ibericus","name_deutsch":"Iberienzilpzalp","artengruppe":"V\u00f6gel","gid":346562,"is_animal":true},…]}
Beispiel: Liste der Arten zur Artengruppen-ID 342930 HTTP GET JSON
https://berlin.artenfinder.net/api/v2/arten?gid=342930
Link
Antwort
{"result":[{"id":710234,"eu_guid":"urn:lsid:faunaeur.org:taxname:447022","name_wissenschaftlich":"Chelis maculosa","name_deutsch":"Schwarzgefleckter Bär","artengruppe":"Baeren- Spinner","gid":342930,"is_animal":true},…]}
Beispiel: Liste der Arten zur Artengruppen-ID 342930 mit Rückgabe in XML HTTP GET XML
https://berlin.artenfinder.net/api/v2/arten?gid=342930&format=xml
Link
Antwort
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xml><result><row><id>710234</id><eu_guid>urn:lsid:faunaeur.org:taxname:447022</eu_guid><name_wissenschaftlich>Chelis maculosa</name_wissenschaftlich><name_deutsch>Schwarzgefleckter Bär</name_deutsch><artengruppe>Baeren- Spinner</artengruppe><gid>342930</gid><is_animal>TRUE</is_animal></row>…</result></xml>
Abfragen (Details einer Art)
Schnittstelle: https://berlin.artenfinder.net/api/v2/arten/:id
Methoden:
optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
Antwort:
- result
- row (XML) / Array (JSON)
- id
- eu_guid
- Eindeutige EU Art-ID
- Datentyp: String
- gid
- Eindeutige Artengruppen-ID
- Datentyp: Integer
- art_id
- Mandantenspezifische Art-ID (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Art-ID des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- name_wissenschaftlich
- Wissenschaftlicher Artname (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo wissenschaftlicher Artname des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- name_deutsch
- Deutscher Artname (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo deutscher Artname des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- sensibel
- Mandantenspezifisch naturschutzfachlich sensible Art (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. Artdefinition des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: Boolean
- artengruppe
- Deutscher Artengruppenname
- Datentyp: String
- is_animal
- Pflanze oder Tier
- Datentyp: Boolean
- bluetenmerkmale
- Blütenmerkmale (ArtenInfo-Artenportrait)
- Datentyp: String
- bluetezeit
- Blütezeit (ArtenInfo-Artenportrait)
- Datentyp: String
- fortpflanzung
- Fortpflanzung (ArtenInfo-Artenportrait)
- Datentyp: String
- gefaehrdung
- Gefährdung (ArtenInfo-Artenportrait)
- Datentyp: String
- lebensraum
- Lebensraum (ArtenInfo-Artenportrait)
- Datentyp: String
- nahrung
- Nahrung (ArtenInfo-Artenportrait)
- Datentyp: String
- oekologie
- Ökologie (ArtenInfo-Artenportrait)
- Datentyp: String
- quelle
- Quelle (ArtenInfo-Artenportrait)
- Datentyp: String
- ueberregionale_verbreitung
- Überregionale Verbreitung (ArtenInfo-Artenportrait)
- Datentyp: String
- regionale_verbreitung
- Mandantenspezifisch regionale Verbreitung (ArtenInfo-Artenportrait), Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain, z.B. Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api)
- Datentyp: String
- schutzwuerdigkeit_und_schutzstatus
- Schutzwürdigkeit und Schutzstatus (ArtenInfo-Artenportrait)
- Datentyp: String
- vegetative_merkmale
- Vegetative Merkmale (ArtenInfo-Artenportrait)
- Datentyp: String
- verhalten
- Verhalten (ArtenInfo-Artenportrait)
- Datentyp: String
- foto
- Artfotos (ArtenInfo-Artenportrait)
- Datentyp: Liste (XML) / Array (JSON)
- uri
- autor
- bildunterschrift
- Bildunterschrift
- Datentyp: String
- lizenz
- verwechslungsgefahr
- Verwechslungsgefahren (ArtenInfo-Artenportrait)
- Datentyp: Liste (XML) / Array (JSON)
- beschreibung
- Beschreibung der Verwechslungsgefahr
- Datentyp: String
- art
- Arten der Verwechslungsgefahr
- Datentyp: Liste (XML) / Array (JSON)
- foto
- Artfotos der Verwechslungsgefahr
- Datentyp: Liste (XML) / Array (JSON)
- uri
- autor
- bildunterschrift
- Bildunterschrift
- Datentyp: String
- lizenz
Beispiel: Detailanfrage einer Art HTTP GET JSON Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/arten/103041
Link
Antwort
{"result":[{"id":103041,"eu_guid":"urn:lsid:faunaeur.org:taxname:97276","name_wissenschaftlich":"Parus major","name_deutsch":"Kohlmeise","artengruppe":"V\u00f6gel","gid":6,"is_animal":true,"art_id":null,"sensibel":false,"oekologie":null,"lebensraum":"Br\u00fctet in nahezu allen Habitaten mit Baum- und darin H\u00f6hlen-Bestand, mit Vorliebe f\u00fcr lichten Mischwald. Bei Nist\u00adh\u00f6hlen-Angebot und bei ausreichender Nahrung auch in baumarme Gebiete vordringend, dabei auch gerne in Sied\u00adlungen des Menschen. Der aus Energie- Gr\u00fcnden inzwischen weitreichende W\u00e4r\u00admeschutz von Geb\u00e4uden hat die Zahl von Nischen und H\u00f6hlungen stark reduziert. Auch \u00e4lterer Baumbestand mit H\u00f6hlun\u00adgen f\u00e4llt heute aus Sicherheitsgr\u00fcnden meist bald der S\u00e4ge zum Opfer. Insofern sind Kohlmeise wie auch etwa Blaumeise f\u00fcr ein Angebot an k\u00fcnstlichen Nisth\u00f6h\u00adlen sehr dankbar. Die Kohlmeise streift au\u00dferhalb der Brutzeit gerne in gemisch\u00adten Kleinvogel-Schw\u00e4rmen umher, z.B. mit anderen Meisen-Arten in W\u00e4ldern. Im Winter ist sie regelm\u00e4\u00dfig Gast an Fut\u00adterh\u00e4usern. In eiligem An- und Wegflug holt sie Sonnenblumenkerne und \u00f6ffnet sie, in Deckung mit den Zehen an einem \u00c4stchen festgeklemmt, durch mehrfa\u00adches kr\u00e4ftiges Zuschlagen mit dem spit\u00adzen Schnabel.","vegetative_merkmale":null,"bluetenmerkmale":null,"bluetezeit":null,"gefaehrdung":"Nat\u00fcrliche Verluste meist aufgrund von K\u00e4ltewintern und ung\u00fcnstiger Witterung w\u00e4hrend der Brutzeit sowie durch Beutegreifer.","ueberregionale_verbreitung":"Von NW-Afrika \u00fcber W-Europa bis zum Pazifik \u00fcber die n\u00f6rdliche, gem\u00e4\u00dfigte bis zur tropischen Zone in Indien, im Tiefland bis zur Berglage weit verbreitet. In Mitteleuropa die h\u00e4ufigste Meisenart. Der europ\u00e4ische Gesamtbestand wird sehr grob auf 37 - 52 Mio. BP gesch\u00e4tzt und als stabil gewertet (HAGEMEIJER & BLAIR 1997).","nahrung":"\u00dcberwiegend kleine Gliederf\u00fc\u00dfer unterschiedlicher Arten. Ab Sp\u00e4tsommer S\u00e4mereien, Bucheckern, auch Beeren und Obst. Im Winter an Futterstellen, pickt im Fr\u00fchjahr auch Knospen.","quelle":null,"fortpflanzung":"H\u00f6hlenbr\u00fcter. Alle m\u00f6glichen H\u00f6hlentypen, bis hin zu Briefk\u00e4sten und Spalten in Fels oder Gem\u00e4uer, werden angenommen. Bei Bedarf werden morsche Baumh\u00f6hlen durch Schnabelbearbeitung erweitert. Neststandort zwischen 0,5 und 10 m H\u00f6he. Nestbaumaterial Moos, mit dicker, aus Tierhaaren zusammengesetzter Mulde. Eiablage in Ausnahmejahren ab Ende Februar, sonst witterungsabh\u00e4ngig oft erst ab Ende M\u00e4rz (BEZZEL 1993). Gelegegr\u00f6\u00dfe 8 - 12, meist 7 - 10 Eier. Anzahl der Eier korreliert mit der Brutraumgr\u00f6\u00dfe, weshalb Nistk\u00e4sten oft mehr Eier enthalten als Naturh\u00f6hlen (L\u00d6HRL 1973, zit. nach BEZZEL 1993). Brutdauer 13 - 14 Tage, Nestlingsdauer 18 -21 Tage. Ein - zwei Jahresbruten. Ein Teil der Zweitbruten und wohl alle Nachgelege erfolgen in neuen Nesth\u00f6hlen.","verhalten":"Tagaktiv. Bei der Nahrungssuche in Str\u00e4uchern und B\u00e4umen weniger weit au\u00dfen suchend als andere Meisenarten. Sucht auch Boden (Falllaub) ab. In der Brutzeit territorial, sonst auch kleine Trupps bildend. Im Winter \u00dcbernachtung einzeln in Schlafh\u00f6hlen, wobei das M\u00e4nnchen sein Weibchen zu dessen Schlafh\u00f6hle begleitet und es morgens dort abholt. Dies soll Fremdkopulationen verhindern, da ab Ende Winter Kopulationen fast ausschlie\u00dflich morgens erfolgen (MACE 1988, zit. nach BEZZEL 1993).","schutzwuerdigkeit_und_schutzstatus":null,"verwechslungsgefahr":{"art":[{"aid":103043},{"aid":103039}],"foto":[{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3428","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Tannenmeise im Vergleich: viel kleiner, kein gelb, kein blau"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3429","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Blaumeise im Vergleich: blaue Kappe, kein schwarzes Band am Bauch, deutlich kleiner"}],"beschreibung":null},"foto":[{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/1646","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"M\u00e4nnliche Kohlmeise mit breitem, durchgehendem schwarzem Band am Bauch"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/1647","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Weibliche Kohlmeise mit schmalem schwarzem Band"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/1648","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Kohlmeise, Jungvogel"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3425","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"R\u00fcckenansicht"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3426","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Weibliche Kohlmeise im Flug"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3427","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"M\u00e4nnliche Kohlmeise mit breitem schwarzem Band am Bauch"}],"regionale_verbreitung":"Mehrere tausend Meldungen seit 2010 in Rheinland-Pfalz belegen, dass die Kohl\u00admeise ein regelm\u00e4\u00dfiger und sehr h\u00e4ufi\u00adger Brut- und Jahresvogel in geeigneten Lebensr\u00e4umen in allen Landesteilen ist. Sie ist ein typischer Standvogel, der sich das ganze Jahr \u00fcber im gleichen Gebiet aufh\u00e4lt. Im Winter kommen auch Durch\u00adz\u00fcgler in Rheinland-Pfalz vor."}]}
Beispiel: Detailanfrage einer Art beantwortet in XML HTTP GET XML Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/arten/103041?format=xml
Link
Antwort
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><xml><result><row><id><![CDATA[103041]]></id><eu_guid><![CDATA[urn:lsid:faunaeur.org:taxname:97276]]></eu_guid><name_wissenschaftlich><![CDATA[Parus major]]></name_wissenschaftlich><name_deutsch><![CDATA[Kohlmeise]]></name_deutsch><artengruppe><![CDATA[Vögel]]></artengruppe><gid><![CDATA[6]]></gid><is_animal><![CDATA[TRUE]]></is_animal><art_id><![CDATA[]]></art_id><sensibel><![CDATA[FALSE]]></sensibel><oekologie><![CDATA[]]></oekologie><lebensraum><![CDATA[Brütet in nahezu allen Habitaten mit Baum- und darin Höhlen-Bestand, mit Vorliebe für lichten Mischwald. Bei Nisthöhlen-Angebot und bei ausreichender Nahrung auch in baumarme Gebiete vordringend, dabei auch gerne in Siedlungen des Menschen. Der aus Energie- Gründen inzwischen weitreichende Wärmeschutz von Gebäuden hat die Zahl von Nischen und Höhlungen stark reduziert. Auch älterer Baumbestand mit Höhlungen fällt heute aus Sicherheitsgründen meist bald der Säge zum Opfer. Insofern sind Kohlmeise wie auch etwa Blaumeise für ein Angebot an künstlichen Nisthöhlen sehr dankbar. Die Kohlmeise streift außerhalb der Brutzeit gerne in gemischten Kleinvogel-Schwärmen umher, z.B. mit anderen Meisen-Arten in Wäldern. Im Winter ist sie regelmäßig Gast an Futterhäusern. In eiligem An- und Wegflug holt sie Sonnenblumenkerne und öffnet sie, in Deckung mit den Zehen an einem Ästchen festgeklemmt, durch mehrfaches kräftiges Zuschlagen mit dem spitzen Schnabel.]]></lebensraum><vegetative_merkmale><![CDATA[]]></vegetative_merkmale><bluetenmerkmale><![CDATA[]]></bluetenmerkmale><bluetezeit><![CDATA[]]></bluetezeit><gefaehrdung><![CDATA[Natürliche Verluste meist aufgrund von Kältewintern und ungünstiger Witterung während der Brutzeit sowie durch Beutegreifer.]]></gefaehrdung><ueberregionale_verbreitung><![CDATA[Von NW-Afrika über W-Europa bis zum Pazifik über die nördliche, gemäßigte bis zur tropischen Zone in Indien, im Tiefland bis zur Berglage weit verbreitet. In Mitteleuropa die häufigste Meisenart. Der europäische Gesamtbestand wird sehr grob auf 37 - 52 Mio. BP geschätzt und als stabil gewertet (HAGEMEIJER & BLAIR 1997).]]></ueberregionale_verbreitung><nahrung><![CDATA[Überwiegend kleine Gliederfüßer unterschiedlicher Arten. Ab Spätsommer Sämereien, Bucheckern, auch Beeren und Obst. Im Winter an Futterstellen, pickt im Frühjahr auch Knospen.]]></nahrung><quelle><![CDATA[]]></quelle><fortpflanzung><![CDATA[Höhlenbrüter. Alle möglichen Höhlentypen, bis hin zu Briefkästen und Spalten in Fels oder Gemäuer, werden angenommen. Bei Bedarf werden morsche Baumhöhlen durch Schnabelbearbeitung erweitert. Neststandort zwischen 0,5 und 10 m Höhe. Nestbaumaterial Moos, mit dicker, aus Tierhaaren zusammengesetzter Mulde. Eiablage in Ausnahmejahren ab Ende Februar, sonst witterungsabhängig oft erst ab Ende März (BEZZEL 1993). Gelegegröße 8 - 12, meist 7 - 10 Eier. Anzahl der Eier korreliert mit der Brutraumgröße, weshalb Nistkästen oft mehr Eier enthalten als Naturhöhlen (LÖHRL 1973, zit. nach BEZZEL 1993). Brutdauer 13 - 14 Tage, Nestlingsdauer 18 -21 Tage. Ein - zwei Jahresbruten. Ein Teil der Zweitbruten und wohl alle Nachgelege erfolgen in neuen Nesthöhlen.]]></fortpflanzung><verhalten><![CDATA[Tagaktiv. Bei der Nahrungssuche in Sträuchern und Bäumen weniger weit außen suchend als andere Meisenarten. Sucht auch Boden (Falllaub) ab. In der Brutzeit territorial, sonst auch kleine Trupps bildend. Im Winter Übernachtung einzeln in Schlafhöhlen, wobei das Männchen sein Weibchen zu dessen Schlafhöhle begleitet und es morgens dort abholt. Dies soll Fremdkopulationen verhindern, da ab Ende Winter Kopulationen fast ausschließlich morgens erfolgen (MACE 1988, zit. nach BEZZEL 1993).]]></verhalten><schutzwuerdigkeit_und_schutzstatus><![CDATA[]]></schutzwuerdigkeit_und_schutzstatus><verwechslungsgefahr><beschreibung><![CDATA[]]></beschreibung><foto><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/3428]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Tannenmeise im Vergleich: viel kleiner, kein gelb, kein blau]]></bildunterschrift></row><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/3429]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Blaumeise im Vergleich: blaue Kappe, kein schwarzes Band am Bauch, deutlich kleiner]]></bildunterschrift></row></foto><art><row><aid>103043</aid></row><row><aid>103039</aid></row></art></verwechslungsgefahr><foto><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/1646]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Männliche Kohlmeise mit breitem, durchgehendem schwarzem Band am Bauch]]></bildunterschrift></row><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/1647]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Weibliche Kohlmeise mit schmalem schwarzem Band]]></bildunterschrift></row><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/1648]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Kohlmeise, Jungvogel]]></bildunterschrift></row><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/3425]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Rückenansicht]]></bildunterschrift></row><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/3426]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Weibliche Kohlmeise im Flug]]></bildunterschrift></row><row><uri><![CDATA[https://arteninfo.net/elearning/voegel/get_image/3427]]></uri><autor><![CDATA[R.Roessner]]></autor><lizenz><![CDATA[CC BY-NC-SA 4.0]]></lizenz><bildunterschrift><![CDATA[Männliche Kohlmeise mit breitem schwarzem Band am Bauch]]></bildunterschrift></row></foto><regionale_verbreitung><![CDATA[Mehrere tausend Meldungen seit 2010 in Rheinland-Pfalz belegen, dass die Kohlmeise ein regelmäßiger und sehr häufiger Brut- und Jahresvogel in geeigneten Lebensräumen in allen Landesteilen ist. Sie ist ein typischer Standvogel, der sich das ganze Jahr über im gleichen Gebiet aufhält. Im Winter kommen auch Durchzügler in Rheinland-Pfalz vor.]]></regionale_verbreitung></row></result></xml>
Beispiel: Detailanfrage einer Art beantwortet in JavaScript mittels JSONP HTTP GET JavaScript (JSONP) Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/arten/103041?callback=myResponseFunc
Link
Antwort
myResponseFunc({"result":[{"id":103041,"eu_guid":"urn:lsid:faunaeur.org:taxname:97276","name_wissenschaftlich":"Parus major","name_deutsch":"Kohlmeise","artengruppe":"V\u00f6gel","gid":6,"is_animal":true,"art_id":null,"sensibel":false,"oekologie":null,"lebensraum":"Br\u00fctet in nahezu allen Habitaten mit Baum- und darin H\u00f6hlen-Bestand, mit Vorliebe f\u00fcr lichten Mischwald. Bei Nist\u00adh\u00f6hlen-Angebot und bei ausreichender Nahrung auch in baumarme Gebiete vordringend, dabei auch gerne in Sied\u00adlungen des Menschen. Der aus Energie- Gr\u00fcnden inzwischen weitreichende W\u00e4r\u00admeschutz von Geb\u00e4uden hat die Zahl von Nischen und H\u00f6hlungen stark reduziert. Auch \u00e4lterer Baumbestand mit H\u00f6hlun\u00adgen f\u00e4llt heute aus Sicherheitsgr\u00fcnden meist bald der S\u00e4ge zum Opfer. Insofern sind Kohlmeise wie auch etwa Blaumeise f\u00fcr ein Angebot an k\u00fcnstlichen Nisth\u00f6h\u00adlen sehr dankbar. Die Kohlmeise streift au\u00dferhalb der Brutzeit gerne in gemisch\u00adten Kleinvogel-Schw\u00e4rmen umher, z.B. mit anderen Meisen-Arten in W\u00e4ldern. Im Winter ist sie regelm\u00e4\u00dfig Gast an Fut\u00adterh\u00e4usern. In eiligem An- und Wegflug holt sie Sonnenblumenkerne und \u00f6ffnet sie, in Deckung mit den Zehen an einem \u00c4stchen festgeklemmt, durch mehrfa\u00adches kr\u00e4ftiges Zuschlagen mit dem spit\u00adzen Schnabel.","vegetative_merkmale":null,"bluetenmerkmale":null,"bluetezeit":null,"gefaehrdung":"Nat\u00fcrliche Verluste meist aufgrund von K\u00e4ltewintern und ung\u00fcnstiger Witterung w\u00e4hrend der Brutzeit sowie durch Beutegreifer.","ueberregionale_verbreitung":"Von NW-Afrika \u00fcber W-Europa bis zum Pazifik \u00fcber die n\u00f6rdliche, gem\u00e4\u00dfigte bis zur tropischen Zone in Indien, im Tiefland bis zur Berglage weit verbreitet. In Mitteleuropa die h\u00e4ufigste Meisenart. Der europ\u00e4ische Gesamtbestand wird sehr grob auf 37 - 52 Mio. BP gesch\u00e4tzt und als stabil gewertet (HAGEMEIJER & BLAIR 1997).","nahrung":"\u00dcberwiegend kleine Gliederf\u00fc\u00dfer unterschiedlicher Arten. Ab Sp\u00e4tsommer S\u00e4mereien, Bucheckern, auch Beeren und Obst. Im Winter an Futterstellen, pickt im Fr\u00fchjahr auch Knospen.","quelle":null,"fortpflanzung":"H\u00f6hlenbr\u00fcter. Alle m\u00f6glichen H\u00f6hlentypen, bis hin zu Briefk\u00e4sten und Spalten in Fels oder Gem\u00e4uer, werden angenommen. Bei Bedarf werden morsche Baumh\u00f6hlen durch Schnabelbearbeitung erweitert. Neststandort zwischen 0,5 und 10 m H\u00f6he. Nestbaumaterial Moos, mit dicker, aus Tierhaaren zusammengesetzter Mulde. Eiablage in Ausnahmejahren ab Ende Februar, sonst witterungsabh\u00e4ngig oft erst ab Ende M\u00e4rz (BEZZEL 1993). Gelegegr\u00f6\u00dfe 8 - 12, meist 7 - 10 Eier. Anzahl der Eier korreliert mit der Brutraumgr\u00f6\u00dfe, weshalb Nistk\u00e4sten oft mehr Eier enthalten als Naturh\u00f6hlen (L\u00d6HRL 1973, zit. nach BEZZEL 1993). Brutdauer 13 - 14 Tage, Nestlingsdauer 18 -21 Tage. Ein - zwei Jahresbruten. Ein Teil der Zweitbruten und wohl alle Nachgelege erfolgen in neuen Nesth\u00f6hlen.","verhalten":"Tagaktiv. Bei der Nahrungssuche in Str\u00e4uchern und B\u00e4umen weniger weit au\u00dfen suchend als andere Meisenarten. Sucht auch Boden (Falllaub) ab. In der Brutzeit territorial, sonst auch kleine Trupps bildend. Im Winter \u00dcbernachtung einzeln in Schlafh\u00f6hlen, wobei das M\u00e4nnchen sein Weibchen zu dessen Schlafh\u00f6hle begleitet und es morgens dort abholt. Dies soll Fremdkopulationen verhindern, da ab Ende Winter Kopulationen fast ausschlie\u00dflich morgens erfolgen (MACE 1988, zit. nach BEZZEL 1993).","schutzwuerdigkeit_und_schutzstatus":null,"verwechslungsgefahr":{"art":[{"aid":103043},{"aid":103039}],"foto":[{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3428","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Tannenmeise im Vergleich: viel kleiner, kein gelb, kein blau"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3429","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Blaumeise im Vergleich: blaue Kappe, kein schwarzes Band am Bauch, deutlich kleiner"}],"beschreibung":null},"foto":[{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/1646","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"M\u00e4nnliche Kohlmeise mit breitem, durchgehendem schwarzem Band am Bauch"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/1647","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Weibliche Kohlmeise mit schmalem schwarzem Band"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/1648","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Kohlmeise, Jungvogel"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3425","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"R\u00fcckenansicht"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3426","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"Weibliche Kohlmeise im Flug"},{"uri":"https:\/\/arteninfo.net\/elearning\/voegel\/get_image\/3427","autor":"R.Roessner","lizenz":"CC BY-NC-SA 4.0","bildunterschrift":"M\u00e4nnliche Kohlmeise mit breitem schwarzem Band am Bauch"}],"regionale_verbreitung":"Mehrere tausend Meldungen seit 2010 in Rheinland-Pfalz belegen, dass die Kohl\u00admeise ein regelm\u00e4\u00dfiger und sehr h\u00e4ufi\u00adger Brut- und Jahresvogel in geeigneten Lebensr\u00e4umen in allen Landesteilen ist. Sie ist ein typischer Standvogel, der sich das ganze Jahr \u00fcber im gleichen Gebiet aufh\u00e4lt. Im Winter kommen auch Durch\u00adz\u00fcgler in Rheinland-Pfalz vor."}]});
Suchen (nach Artengruppen und Arten)
Schnittstellendefinition
Beispiel: Suche nach Arten HTTP GET JavaScript (JSONP) Ohne Authentifizierung
- mit Ausdruck "Milan" im Namen
- Begrenzung der Antwortliste auf 10 Einträge
- mittels JSONP in Funktion myResponseFunc()
https://berlin.artenfinder.net/api/v2/arten?name_regexp_ci=.*Milan.*&limit=10&callback=myResponseFunc
Link
Antwort
myResponseFunc({"result":[{"id":175867,"eu_guid":"urn:lsid:indexfungorum.org:names:232492","name_wissenschaftlich":"Psilocybe semilanceata","name_deutsch":"Spitzkegeliger Kahlkopf","artengruppe":"Pilze","gid":276441,"is_animal":false},…]});
Beispiel: Suche nach Arten HTTP GET JavaScript (JSONP) Ohne Authentifizierung
- mit Ausdruck "Milan" im Namen
- der Artengruppe Vögel
- Begrenzung der Antwortliste auf 10 Einträge
- mittels JSONP in Funktion myResponseFunc()
https://berlin.artenfinder.net/api/v2/arten?name_regexp_ci=.*Milan.*&artengruppe=Vögel&limit=10&callback=myResponseFunc
Link
Antwort
myResponseFunc({"result":[{"id":103015,"eu_guid":"urn:lsid:marinespecies.org:taxname:212678","name_wissenschaftlich":"Milvus migrans","name_deutsch":"Schwarzmilan","artengruppe":"Vögel","gid":346562,"is_animal":true},…]});
Beispiel: Suche nach Artengruppen HTTP GET JavaScript (JSONP) Ohne Authentifizierung
- aller Pflanzen
- mittels JSONP in Funktion myResponseFunc()
https://berlin.artenfinder.net/api/v2/artengruppen?is_animal=false&callback=myResponseFunc
Link
Antwort
myResponseFunc({"result":[{"id":276441,"name_deutsch":"Pilze","is_animal":false},…]});
Zu Sichtbeobachtungen
Übermitteln (Erstellen neuer Sichtbeobachtungen, inklusive Foto)
Schnittstelle: https://berlin.artenfinder.net/api/v2/sichtbeobachtungen
Methoden:
- POST Authentifizierung erforderlich
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
Datenfelder:
- Pflichtdatenfelder
- art
- lat
- Hochwert, Nord in ETRS89/UTM zone 32N (für eine Übergabe in abweichendem "Spatial Reference Identifier (SRID)" s. unter optionale Datenfelder)
- Datentyp: Double
- lon
- Rechtswert, Ost in ETRS89/UTM zone 32N (für eine Übergabe in abweichendem "Spatial Reference Identifier (SRID)" s. unter optionale Datenfelder)
- Datentyp: Double
- optionale Datenfelder
- srid
- "Spatial Reference Identifier (SRID)" des übergebenen Hoch- und Rechtswertes
- Datentyp: String
- Standardwert: EPSG:25832
- Auswahlwerte:
- EPSG:25832
- EPSG:4326
- WGS 84, World Geodetic System (WGS)
- EPSG:3857
- anzahl
- Anzahl der gesichteten Art
- Datentyp: String
- Standardwert: 1
- Gültiger Wertebereich: 1 - 20000
- sensibel
- Sensible Sichtbeobachtung
- Datentyp: String
- Standardwert: false
- Gültiger Wertebereich: false / true
- datum
- Datum der Sichtbeobachtung
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- Standardwert: Datum der Übermittlung
- bereich
- Ob in den öffentlichen oder in den privaten Bereich einzuordnende Erfassung
- Datentyp: String
- Standardwert: privat
- Auswahlwerte:
- privat
- Sichtbeobachtung wird eingestellt in den privaten Bereich des authentifizierten Nutzers
- oeffentlich
- Sichtbeobachtungen wird eingestellt in den öffentlichen Bereich
- bemerkung
- Bemerkung zur Erfassung
- Datentyp: String
- foto
- Belegfoto
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- foto_2
- Belegfoto 2
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- foto_3
- Belegfoto 3
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- biotopfoto
- Biotopfoto
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- audio
- Tonaufnahme
- Datentyp: File
- Dateityp: Audiodatei (z.B. mp3, wav, aac, amr, awb, m4a, oga oder flac)
- max. Dateigröße: 1 MB
- stadium_id
- Entwicklungsstadium-ID
- Datentyp: String
- aktivitaet_id
- Aktivitätstyp-ID
- Datentyp: String
optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
Antwort (bei erfolgreicher Übermittlung): Hinweisende Antwort auf die erstellte Sichtbeobachtung mit
HTTP/1.1 201 Created
Antwort (bei fehlerhaftem Übermittlungsversuch): Hinweisende Antwort mit
HTTP/1.1 400 Bad Request
Vorlage: Authentifizierte POST Übermittlung einer Sichtbeobachtung inklusive eines Fotos HTTP POST Mit Authentifizierung
POST /api/v2/sichtbeobachtungen HTTP/1.1
Host: berlin.artenfinder.net
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Content-Length: 7893278
Content-Type: multipart/form-data; charset=utf-8; boundary=--------------------31063722920652
------------------------------31063722920652
Content-Disposition: form-data; name="art"
710277
------------------------------31063722920652
Content-Disposition: form-data; name="srid"
EPSG:25832
------------------------------31063722920652
Content-Disposition: form-data; name="lon"
446417
------------------------------31063722920652
Content-Disposition: form-data; name="lat"
5542795
------------------------------31063722920652
Content-Disposition: form-data; name="foto"; filename="sb.jpeg"
Content-Type: image/jpeg
AX32qD...
-----------------------------31063722920652--
Eine authentifizierte Übermittlung einer Sichtbeobachtung mittels cURL
Beispiel: Authentifizierte POST Übermittlung einer Sichtbeobachtung inklusive 2 Belegfotos, einem Biotopfoto und Tondatei in der Kommandozeile mittels cURL cURL HTTP POST Mit Authentifizierung
curl -i -H "X-Auth-User: jdoe" -H "X-Auth-Token: pndVpURTRaREkz" -H "Content-Type: multipart/form-data; charset=utf-8" -F "art=710277" -F "lon=446417" -F "lat=5542795" -F "srid=EPSG:25832" -F "foto=@sb.jpeg" -F "foto_2=@sb2.jpeg" -F "biotopfoto=@biotop.jpeg" -F "audio=@aufnahme.mp3" -X POST https://berlin.artenfinder.net/api/v2/sichtbeobachtungen
Eine authentifizierte Übermittlung einer Sichtbeobachtung in PHP
Beispiel: Authentifizierte POST Übermittlung einer Sichtbeobachtung inklusive 2 Belegfotos, einem Biotopfoto und Tondatei in PHP PHP HTTP POST Mit Authentifizierung
define('MULTIPART_BOUNDARY', '--------------------------'.microtime(true));
$contents = file_get_contents( 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen', false, stream_context_create( array( 'http' => array(
'method' => 'POST',
'header' => Array('X-Auth-User: jdoe', 'X-Auth-Token: pndVpURTRaREkz', 'Content-Type: multipart/form-data; charset=utf-8; boundary='.MULTIPART_BOUNDARY),
'content' =>
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="art"'."\r\n\r\n".
'710277'."\r\n".
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="srid"'."\r\n\r\n".
'EPSG:25832'."\r\n".
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="lon"'."\r\n\r\n".
'446417'."\r\n".
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="lat"'."\r\n\r\n".
'5542795'."\r\n".
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="foto"; filename="sb.jpeg"'."\r\n".
'Content-Type: image/jpeg'."\r\n\r\n".file_get_contents('./sb.jpeg')."\r\n".
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="foto_2"; filename="sb2.jpeg"'."\r\n".
'Content-Type: image/jpeg'."\r\n\r\n".file_get_contents('./sb2.jpeg')."\r\n".
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="biotopfoto"; filename="biotop.jpeg"'."\r\n".
'Content-Type: image/jpeg'."\r\n\r\n".file_get_contents('./biotop.jpeg')."\r\n".
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="audio"; filename="aufnahme.mp3"'."\r\n".
'Content-Type: audio/mpeg'."\r\n\r\n".file_get_contents('./aufnahme.mp3')."\r\n".
'--'.MULTIPART_BOUNDARY.'--'."\r\n"
))));
Eine authentifizierte Übermittlung einer Sichtbeobachtung in JavaScript
Beispiel: Authentifizierte POST Übermittlung einer Sichtbeobachtung inklusive 2 Belegfotos, einem Biotopfoto und Tondatei in JavaScript / jQuery JavaScript / jQuery HTTP POST (CORS) Mit Authentifizierung
var data = new FormData();
data.append( 'art', '710277' );
data.append( 'srid', 'EPSG:25832' );
data.append( 'lon', '446417' );
data.append( 'lat', '5542795' );
data.append( 'foto', jQuery('input[type="file"][name="foto"]')[0].files[0] );
data.append( 'foto_2', jQuery('input[type="file"][name="foto_2"]')[0].files[0] );
data.append( 'biotopfoto', jQuery('input[type="file"][name="biotopfoto"]')[0].files[0] );
data.append( 'audio', jQuery('input[type="file"][name="audio"]')[0].files[0] );
jQuery.ajax({type: 'POST', crossDomain: true, url: 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen', cache: false, contentType: false, processData: false, data: data,
beforeSend: function(xhr, settings) {
xhr.setRequestHeader('X-Auth-User', 'jdoe');
xhr.setRequestHeader('X-Auth-Token', 'pndVpURTRaREkz');
}, dataType: 'json', success: function(contents) { … }});
Abfragen (Details einer Sichtbeobachtung)
Naturschutzfachlich sensible Arten
Koordinaten für regional naturschutzfachlich sensible Arten oder für als sensibel gekennzeichnete Sichtbeobachtungen werden nicht exakt, sondern als Mittelpunkt eines 5x5km² Rasters ausgegeben. Ausgenommen hiervon sind authentifizierte Nutzer der Rollen Administrator, Experte und Eigentümer der abgerufenen Sichtbeobachtungen.
Schnittstelle: https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/:id
Methoden:
optionaler Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
Antwort:
- result
- row (XML) / Array (JSON)
- id
- Eindeutige ID der Sichtbeobachtung
- Datentyp: Integer
- guid
- Eindeutige GUID (Universally Unique Identifier (UUID) in Version 5) der Sichtbeobachtung
- Datentyp: String
- status
- Status der Erfassung. Ob Freigegeben, in Prüfung, mit Hinweis versehen oder Abgelehnt
- Datentyp: String
- bereich
- Ob öffentlichem, privatem oder sonstigem Bereich zugeordnete Erfassung
- Datentyp: String
- erfasser Authentifizierung erforderlich
- Name des Erfassers
- Datentyp: String
- uid Authentifizierung erforderlich
- Eindeutige Erfasser-ID
- Datentyp: Integer
- experte Authentifizierung erforderlich
- Name des freigebenden Experten
- Datentyp: String
- anzahl
- Anzahl der gesichteten Art
- Datentyp: String
- lat
- Hochwert, Nord in ETRS89/UTM zone 32N
- Datentyp: Double
- lon
- Rechtswert, Ost in ETRS89/UTM zone 32N
- Datentyp: Double
- is_rasterized
- Auskunft ob eine Rasterung der Sichtbeobachtung als Mittelpunkt eines 5x5km² Rasters aufgrund einer regional (bzw. mandantenabhängig) naturschutzfachlich sensiblen Art oder als sensibel gekennzeichneter Sichtbeobachtung vorgenommen werden musste (s. naturschutzfachlich sensible Arten)
- Datentyp: Boolean
- sensible_art
- Auskunft ob die Sichtbeobachtung durch eine regional (bzw. mandantenspezifisch), naturschutzfachlich sensible Art als sensibel gekennzeichnet ist
- Datentyp: Boolean
- sensibel
- Auskunft ob die Sichtbeobachtung durch den Erfasser als sensibel gekennzeichnet ist
- Datentyp: Boolean
- datum
- Datum der Erfassung
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- titel_deutsch
- Deutscher Name der gesichteten Art (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo deutscher Artname des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- titel_wissenschaftlich
- Wissenschaftlicher Name der gesichteten Art (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo wissenschaftlicher Artname des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- eu_guid
- Eindeutige EU Art-ID
- Datentyp: String
- art
- art_id
- Mandanten-spezifische Art-ID (Quelle: Mandanten-spezifische Art-ID anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Art-ID des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- lanis_rlp_osiris_art_id
- OSIRIS Art-ID des Landesinformationssystems Rheinland-Pfalz (Markiert als "deprecated", verwenden Sie die neu eingeführte "art_id" um die mandanten-spezifische Art-ID, wie z.B. OSIRIS / ONeo Art-ID des Landesinformationssystems Rheinland-Pfalz, auszulesen)
- Datentyp: Integer
- is_animal
- Filter ob Pflanzen- oder Tierart
- Datentyp: Boolean
- phaenogramm
- Status ob die Sichtbeobachtung im Phänogramm berücksichtigt werden kann (z.B. kein Larvenfund bei Schmetterlingen)
- Datentyp: Boolean
- stadium
- Entwicklungsstadium
- Datentyp: String
- stadium_id
- Eindeutige Entwicklungsstadium-ID
- Datentyp: Integer
- aktivitaet
- Aktivitätstyp
- Datentyp: String
- aktivitaet_id
- Eindeutige Aktivitätstyp-ID
- Datentyp: Integer
- artengruppe
- Artengruppenname
- Datentyp: String
- artengruppe_id
- Eindeutige Artengruppen-ID
- Datentyp: Integer
- lanis_rlp_osiris_artengruppe_id
- OSIRIS Artengruppen-ID des Landesinformationssystems Rheinland-Pfalz (Markiert als "deprecated", verwenden Sie die neu eingeführte "artengruppe_id" um die eindeutige Artengruppen-ID auszulesen
- Datentyp: Integer
- bemerkung
- Bemerkung des Erfassers
- Datentyp: String
- bemerkung_experte
- Bemerkung des Experten Authentifizierung erforderlich
- Datentyp: String
- foto
- Belegfoto
- Datentyp: String
- Datenformat: URL
- foto_2
- Belegfoto 2
- Datentyp: String
- Datenformat: URL
- foto_3
- Belegfoto 3
- Datentyp: String
- Datenformat: URL
- biotopfoto
- Biotopfoto
- Datentyp: String
- Datenformat: URL
- audio
- Tonaufnahme
- Datentyp: String
- Datenformat: URL
- mandanten
- Zugehörige Mandanten (Geographische Zuordnung an im Portal hinterlegte Gebiete / Mandanten)
- Datentyp: Liste (XML) / Array (JSON)
Beispiel: Detailanfrage einer Sichtbeobachtung HTTP GET JSON Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/50180093
Link
Antwort
{"result":[{"id":50180093,"bereich":"Öffentliche Meldungen","status":"Freigegeben","anzahl":"1","lon":452768,"lat":5448391,"datum":"01.10.2013","titel_deutsch":"Herbst-Mosaikjungfer","titel_wissenschaftlich":"Aeshna mixta","foto":"https://berlin.artenfinder.net/sites/default/files/afsp/multimedia/foto/sb/2013/10/01/50180093_1.jpg","eu_guid":"urn:lsid:faunaeur.org:taxname:214308","lanis_rlp_osiris_art_id":6833,"phaenogramm":true,"is_animal":true,"artengruppe":"Libellen","lanis_rlp_osiris_artengruppe_id":342431,"stadium_id":0,"stadium":null,"aktivitaet_id":0,"aktivitaet":null,"mandanten":[{"kuerzel":"RP","name":"Rheinland-Pfalz"}]}]}
Beispiel: Detailanfrage einer Sichtbeobachtung beantwortet in XML HTTP GET XML Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/50180093?format=xml
Link
Antwort
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xml><result><row><id>50180093</id><bereich>Öffentliche Meldungen</bereich><status>Freigegeben</status><anzahl><![CDATA[1]]></anzahl><lon>452768</lon><lat>5448391</lat><datum>01.10.2013</datum><titel_deutsch>Herbst-Mosaikjungfer</titel_deutsch><titel_wissenschaftlich>Aeshna mixta</titel_wissenschaftlich><foto>https://berlin.artenfinder.net/sites/default/files/afsp/multimedia/foto/sb/2013/10/01/50180093_1.jpg</foto><eu_guid>urn:lsid:faunaeur.org:taxname:214308</eu_guid><lanis_rlp_osiris_art_id>6833</lanis_rlp_osiris_art_id><is_animal>TRUE</is_animal><phaenogramm>TRUE</phaenogramm><artengruppe>Libellen</artengruppe><lanis_rlp_osiris_artengruppe_id>342431</lanis_rlp_osiris_artengruppe_id><stadium_id>0</stadium_id><stadium/><aktivitaet_id>0</aktivitaet_id><aktivitaet/><mandanten><row><kuerzel>RP</kuerzel><name>Rheinland-Pfalz</name></row></mandanten></row></result></xml>
Beispiel: Detailanfrage einer Sichtbeobachtung beantwortet in JavaScript mittels JSONP HTTP GET JavaScript (JSONP) Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/50180093?callback=myResponseFunc
Link
Antwort
myResponseFunc({"result":[{"id":50180093,"bereich":"Öffentliche Meldungen","status":"Freigegeben","anzahl":"1","lon":452768,"lat":5448391,"datum":"01.10.2013","titel_deutsch":"Herbst-Mosaikjungfer","titel_wissenschaftlich":"Aeshna mixta","foto":"https://berlin.artenfinder.net/sites/default/files/afsp/multimedia/foto/sb/2013/10/01/50180093_1.jpg","eu_guid":"urn:lsid:faunaeur.org:taxname:214308","lanis_rlp_osiris_art_id":6833,"phaenogramm":true,"is_animal":true,"artengruppe":"Libellen","lanis_rlp_osiris_artengruppe_id":342431,"stadium_id":0,"stadium":null,"aktivitaet_id":0,"aktivitaet":null,"mandanten":[{"kuerzel":"RP","name":"Rheinland-Pfalz"}]}]});
Bearbeiten (einer Sichtbeobachtung)
Schnittstelle: https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/:id
Rechteverwaltung
Die Berechtigung zur Bearbeitung besitzt der Autor einer Sichtbeobachtung soweit diese nicht durch Experten freigegeben wurde. Hierbei lassen sich Datenfelder nur im privatem Bereich nachbearbeiten (ein Sonderfall stellt bereich dar welches ohne Bereichseinschränkung editiert werden kann).
Hinweise zur Bearbeitung
Zur Entfernung einzelner Fotos, der Tondatei oder der Bemerkung das entsprechende Datenfeld mit leerem Inhalt übertragen.
Die übertragene Bemerkung bemerkung wird entsprechend dem anfragestellendem, authorisierten Nutzer (Autoren- oder Expertenbemerkung) zugeordnet.
Methoden:
- PUT Authentifizierung erforderlich
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
Datenfelder:
- art
- lat
- Hochwert, Nord in ETRS89/UTM zone 32N (für eine Übergabe in abweichendem "Spatial Reference Identifier (SRID)" s. unter Datenfeld srid)
- Datentyp: Double
- lon
- Rechtswert, Ost in ETRS89/UTM zone 32N (für eine Übergabe in abweichendem "Spatial Reference Identifier (SRID)" s. unter Datenfeld srid)
- Datentyp: Double
- srid
- "Spatial Reference Identifier (SRID)" des übergebenen Hoch- und Rechtswertes
- Datentyp: String
- Standardwert: EPSG:25832
- Auswahlwerte:
- EPSG:25832
- EPSG:4326
- WGS 84, World Geodetic System (WGS)
- EPSG:3857
- anzahl
- Anzahl der gesichteten Art
- Datentyp: String
- Standardwert: 1
- sensibel
- Sensible Sichtbeobachtung
- Datentyp: String
- Standardwert: false
- Gültiger Wertebereich: false / true
- datum
- Datum der Sichtbeobachtung
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- Standardwert: Datum der Übermittlung
- bereich
- Ob in den öffentlichen oder in den privaten Bereich einzuordnende Erfassung
- Datentyp: String
- Standardwert: privat
- Auswahlwerte:
- privat
- Sichtbeobachtung wird eingestellt in den privaten Bereich des authentifizierten Nutzers
- oeffentlich
- Sichtbeobachtungen wird eingestellt in den öffentlichen Bereich
- bemerkung
- Bemerkung zur Erfassung
- Datentyp: String
- foto
- Belegfoto
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- foto_2
- Belegfoto 2
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- foto_3
- Belegfoto 3
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- biotopfoto
- Biotopfoto
- Datentyp: File
- Dateityp: jpg/jpeg
- max. Dateigröße: 12 MB - wird intern auf weniger als 500 KB komprimiert
- audio
- Tonaufnahme
- Datentyp: File
- Dateityp: Audiodatei (z.B. mp3, wav, aac, amr, awb, m4a, oga oder flac)
- max. Dateigröße: 1 MB
- stadium_id
- Entwicklungsstadium-ID
- Datentyp: String
- aktivitaet_id
- Aktivitätstyp-ID
- Datentyp: String
optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
Antwort (bei erfolgreicher Bearbeitung):
HTTP/1.1 200 OK
Antwort (bei zwar authentisierter jedoch unberechtigter Anfrage):
HTTP/1.1 403 Forbidden
Vorlage: Authentifizierte PUT Anfrage HTTP PUT Mit Authentifizierung
PUT /api/v2/sichtbeobachtungen/325627 HTTP/1.1
Host: berlin.artenfinder.net
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Content-Type: multipart/form-data; charset=utf-8; boundary=--------------------31063722920652
------------------------------31063722920652
Content-Disposition: form-data; name="bemerkung"
Eine abgeänderte Bemerkung
-----------------------------31063722920652--
Einige Umgebungen unterstützen u.U. die REST Methode PUT nicht, oder die Umsetzung ist schwierig. Hierfür erlaubt der Webservice Methoden im Header zu überladen. Verwenden Sie in einem solchen Fall POST und übergeben im Header in X-HTTP-Method-Override die gewünschte Methode PUT.
Vorlage: Authentifizierte PUT Anfrage über POST senden HTTP PUT (OVERRIDING POST) Mit Authentifizierung
POST /api/v2/sichtbeobachtungen/34435 HTTP/1.1
Host: berlin.artenfinder.net
X-HTTP-Method-Override: PUT
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Content-Type: multipart/form-data; charset=utf-8; boundary=--------------------31063722920652
------------------------------31063722920652
Content-Disposition: form-data; name="bemerkung"
Eine abgeänderte Bemerkung
-----------------------------31063722920652--
Eine authentifizierte Bearbeitung einer Sichtbeobachtung mittels cURL
Beispiel: Authentifizierte Bearbeitung einer Sichtbeobachtung in der Kommandozeile mittels cURL cURL HTTP PUT Mit Authentifizierung
curl -i -H "X-Auth-User: jdoe" -H "X-Auth-Token: pndVpURTRaREkz" -H "Content-Type: multipart/form-data; charset=utf-8" -F "bemerkung=Eine abgeänderte Bemerkung" -X PUT https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/124561
Eine authentifizierte Bearbeitung einer Sichtbeobachtung in PHP
Beispiel: Authentifizierte PUT Bearbeitung einer Sichtbeobachtung in PHP PHP HTTP PUT Mit Authentifizierung
define('MULTIPART_BOUNDARY', '--------------------------'.microtime(true));
$contents = file_get_contents( 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/34435', false, stream_context_create( array( 'http' => array(
'method' => 'PUT',
'header' => Array('X-Auth-User: jdoe', 'X-Auth-Token: pndVpURTRaREkz', 'Content-Type: multipart/form-data; charset=utf-8; boundary='.MULTIPART_BOUNDARY),
'content' =>
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="bemerkung"'."\r\n\r\n".
'Eine abgeänderte Bemerkung'."\r\n".
'--'.MULTIPART_BOUNDARY.'--'."\r\n"
))));
Eine authentifizierte Bearbeitung einer Sichtbeobachtung in JavaScript
Beispiel: Authentifizierte PUT Bearbeitung einer Sichtbeobachtung in JavaScript / jQuery JavaScript HTTP PUT (OVERRIDING POST) Mit Authentifizierung
var data = new FormData();
data.append( 'bemerkung', 'Eine abgeänderte Bemerkung' );
jQuery.ajax({type: 'POST', crossDomain: true, url: 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/34435', cache: false, contentType: false, processData: false, data: data,
beforeSend: function(xhr, settings) {
xhr.setRequestHeader('X-HTTP-Method-Override', 'PUT');
xhr.setRequestHeader('X-Auth-User', 'jdoe');
xhr.setRequestHeader('X-Auth-Token', 'pndVpURTRaREkz');
}, dataType: 'json', success: function(contents) { … }});
Löschen (einer Sichtbeobachtung)
Schnittstelle: https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/:id
Rechteverwaltung
Die Berechtigung zum Löschen einer Sichtbeobachtung ist beschränkt auf den Autor soweit diese nicht durch Experten freigegeben wurde. Zusätzlich sind Nutzer der Rolle Administrator berechtigt jedwede veröffentlichte Sichtbeobachtung zu löschen.
Methoden:
- DELETE Authentifizierung erforderlich
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
Antwort (bei erfolgreicher Löschung):
HTTP/1.1 200 OK
Antwort (bei zwar authentisierter jedoch unberechtigter Anfrage):
HTTP/1.1 403 Forbidden
Vorlage: Authentifizierte DELETE Anfrage HTTP DELETE Mit Authentifizierung
DELETE /api/v2/sichtbeobachtungen/325627 HTTP/1.1
Host: berlin.artenfinder.net
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Einige Umgebungen unterstützen u.U. die REST Methode DELETE nicht, oder die Umsetzung ist schwierig. Hierfür erlaubt der Webservice Methoden im Header zu überladen. Verwenden Sie in einem solchen Fall POST und übergeben im Header in X-HTTP-Method-Override die gewünschte Methode DELETE.
Vorlage: Authentifizierte DELETE Anfrage über POST senden HTTP DELETE (OVERRIDING POST) Mit Authentifizierung
POST /api/v2/sichtbeobachtungen/34435 HTTP/1.1
Host: berlin.artenfinder.net
X-HTTP-Method-Override: DELETE
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Eine authentifizierte Löschung einer Sichtbeobachtung mittels cURL
Beispiel: Authentifizierte Löschung einer Sichtbeobachtung in der Kommandozeile mittels cURL cURL HTTP DELETE Mit Authentifizierung
curl -i -H "X-Auth-User: jdoe" -H "X-Auth-Token: pndVpURTRaREkz" -X DELETE https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/124561
Abfragen (der Liste der Sichtbeobachtungen)
Schnittstelle: https://berlin.artenfinder.net/api/v2/sichtbeobachtungen
Rechteverwaltung
Für nicht authentisierte Anfragen ist die Auflistung der Sichtbeobachtungen gefiltert auf veröffentlichte und durch Experten freigegebene Sichtbeobachtungen.
Authensierte Nutzer erhalten eine erweiterte Auflistung aller veröffentlichten Sichtbeobachtungen, uneingeschränkt des jeweiligen Meldestatus. Zusätzlich ist Ihnen die Auflistung des eigenen privaten Bereiches gegeben.
Eine weitere Differenzierung ist in der Antwort einzelner Beobachtungen abgebildet: Detailinformationen wie z.B. Erfasser erfasser sind allein authentisierten Anfragestellern ersichtlich.
Naturschutzfachlich sensible Arten
Koordinaten für regional naturschutzfachlich sensible Arten werden nicht exakt, sondern als Mittelpunkt eines 5x5km² Rasters ausgegeben. Ausgenommen hiervon sind authentifizierte Nutzer der Rollen Administrator, Experte und Eigentümer der abgerufenen Sichtbeobachtungen.
Methoden:
optionaler Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
Parameter:
- optionale Such-/Filterparameter
- bereich
- Filter nach Bereich der Sichtbeobachtungen
- Datentyp: String
- Standardwert: oeffentlich
- Auswahlwerte:
- privat Authentifizierung erforderlich
- Sichtbeobachtungen im privaten Bereich des authentifizierten Nutzers
- oeffentlich
- Sichtbeobachtungen im öffentlichen Bereich
- persoenlich Authentifizierung erforderlich
- Persönlich erfasste Sichtbeobachtungen quer über alle Bereiche des authentifizierten Nutzers
- titel_deutsch
- Auswahl der SB referenziert auf den deutschen Artnamen (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Artdefinition des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- titel_wissenschaftlich
- Auswahl der SB referenziert auf den wissenschaftlichen Artnamen (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Artdefinition des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- eu_guid
- Auswahl nach SB referenziert über die eindeutige EU Art-ID
- Datentyp: String
- art_id
- Auswahl nach SB referenziert über die mandanten-spezifische Art-ID (Quelle: Mandanten-spezifische Art-ID anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Art-ID des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- artengruppe_id
- Auswahl nach SB referenziert über die eindeutige Artengruppen-ID
- Datentyp: Integer
- lanis_rlp_osiris_art_id
- Auswahl nach SB referenziert über die eindeutige Art-ID (Markiert als "deprecated", verwenden Sie den neu eingeführten Parameter "art_id" um nach der mandanten-spezifischen Art-ID, wie z.B. der OSIRIS / ONeo Art-ID des Landesinformationssystems Rheinland-Pfalz, zu filtern)
- Datentyp: Integer
- lanis_rlp_osiris_artengruppe_id
- Auswahl nach SB referenziert über die eindeutige Artengruppen-ID (Markiert als "deprecated", verwenden Sie den neu eingeführten Parameter "artengruppe_id" um nach der Artengruppen-ID zu filtern)
- Datentyp: Integer
- is_animal
- Filter ob Pflanzen- oder Tierart
- Datentyp: Boolean
- Bsp.:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&is_animal=false
Link
- jahr
- Auswahl beschränken auf einen Jahreszeitraum
- Datentyp: Integer
- Bsp.:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&jahr=2010
Link
- datum_von
- Auswahl beschränken auf einschliesslich ab übergebenem Meldedatum
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- Bsp.:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&datum_von=01.01.2011
Link
- datum_bis
- Auswahl beschränken auf einschliesslich bis zum übergebenen Meldedatum
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- Bsp.:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&datum_von=01.01.2012&datum_bis=01.02.2012
Link
- mandant
- Auswahl der SB nach Mandanten
- Datentyp: String
- Datenformat: Kürzel des Mandanten, z.B. Ländercode für Bundesländer: Rheinland-Pfalz = RP, Nordrhein-Westfalen = NW, Baden-Württemberg = BW
- Bsp. für Rheinland-Pfalz:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&mandant=RP
Link
- bbox
- Auswahl der SB nach Suchraum
- Datentyp: String
- Datenformat: Geographische Koordinaten in ETRS89/UTM zone 32N in der Reihenfolge links, unten, rechts, oben
- Bsp.:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&bbox=452768,5448391,452801,5477391
Link
- status
- Auswahl nach aktuellem Status der SB
- Datentyp: String
- Auswahlwerte:
- freigegeben
- Sichtbeobachtung freigegeben
- pruefung Authentifizierung erforderlich
- Sichtbeobachtung in Prüfung
- abgelehnt Authentifizierung erforderlich
- Sichtbeobachtung abgelehnt
- hinweis Authentifizierung erforderlich
- Sichtbeobachtung mit Hinweis versehen
- optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- limit
- Begrenzung der Ergebnisliste
- Datentyp: Integer
- Standardwert: 100
- Gültiger Wertebereich: 1 - 1000
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
- Bsp. für eine Kartenanwendung:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&restrict=id,lat,lon
Link
- Bsp. für eine Restriktion auf den wiss. Artnamen:
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&restrict=id,titel_wissenschaftlich
Link
Antwort:
- result
- row (XML) / Array (JSON)
- id
- Eindeutige ID der Sichtbeobachtung
- Datentyp: Integer
- guid
- Eindeutige GUID (Universally Unique Identifier (UUID) in Version 5) der Sichtbeobachtung
- Datentyp: String
- art
- art_id
- Mandanten-spezifische Art-ID (Quelle: Mandanten-spezifische Art-ID anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Artdefinition des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- lanis_rlp_osiris_art_id
- OSIRIS Art-ID des Landesinformationssystems Rheinland-Pfalz (Markiert als "deprecated", verwenden Sie die neu eingeführte "art_id" um die mandanten-spezifische Art-ID, wie z.B. OSIRIS / ONeo Art-ID des Landesinformationssystems Rheinland-Pfalz, auszulesen)
- Datentyp: Integer
- status
- Status der Erfassung. Ob Freigegeben, in Prüfung, mit Hinweis versehen oder Abgelehnt
- Datentyp: String
- bereich
- Ob öffentlichem, privatem oder sonstigem Bereich zugeordnete Erfassung
- Datentyp: String
- phaenogramm
- Status ob die Sichtbeobachtung im Phänogramm berücksichtigt werden kann (z.B. kein Larvenfund bei Schmetterlingen)
- Datentyp: Boolean
- erfasser Authentifizierung erforderlich
- Name des Erfassers
- Datentyp: String
- uid Authentifizierung erforderlich
- Eindeutige Erfasser-ID
- Datentyp: Integer
- anzahl
- Anzahl der gesichteten Art
- Datentyp: String
- lat
- Hochwert, Nord in ETRS89/UTM zone 32N
- Datentyp: Double
- lon
- Rechtswert, Ost in ETRS89/UTM zone 32N
- Datentyp: Double
- is_rasterized
- Auskunft ob eine Rasterung der Sichtbeobachtung als Mittelpunkt eines 5x5km² Rasters aufgrund einer regional (bzw. mandantenspezifisch), naturschutzfachlich sensiblen Art oder als sensibel gekennzeichneter Sichtbeobachtung vorgenommen werden musste (s. naturschutzfachlich sensible Arten)
- Datentyp: Boolean
- sensible_art
- Auskunft ob die Sichtbeobachtung durch eine regional (bzw. mandantenspezifisch), naturschutzfachlich sensible Art als sensibel gekennzeichnet ist
- Datentyp: Boolean
- sensibel
- Auskunft ob die Sichtbeobachtung durch den Erfasser als sensibel gekennzeichnet ist
- Datentyp: Boolean
- datum
- Datum der Erfassung
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- titel_deutsch
- Deutscher Name der gesichteten Art (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Artdefinition des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- titel_wissenschaftlich
- Wissenschaftlicher Name der gesichteten Art (Quelle: Mandanten-spezifische Artdefinition anhand der angefragten Schnittstellen-Domain z.B. OSIRIS / ONeo Artdefinition des Landesinformationssystems Rheinland-Pfalz (artenfinder.rlp.de/api), Hessen (artenfinder.hessen.de/api) oder Berlin (berlin.artenfinder.net/api))
- Datentyp: String
- bemerkung
- Bemerkung des Erfassers
- Datentyp: String
- bemerkung_experte
- Bemerkung des Experten Authentifizierung erforderlich
- Datentyp: String
- foto
- Belegfoto
- Datentyp: String
- Datenformat: URL
- foto_2
- Belegfoto 2
- Datentyp: String
- Datenformat: URL
- foto_3
- Belegfoto 3
- Datentyp: String
- Datenformat: URL
- biotopfoto
- Biotopfoto
- Datentyp: String
- Datenformat: URL
- audio
- Tonaufnahme
- Datentyp: String
- Datenformat: URL
- next
- Ist die erhaltene Antwort limitiert, wird in next eine URL auf die fortführende Ergebnisliste/Seite aufgezeigt.
- Datentyp: String
Beispiel: Abfrage von Sichtbeobachtungen HTTP GET JSON Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen
Link
Antwort
{"result":[{"id":50180093,"bereich":"Öffentliche Meldungen","status":"Freigegeben","anzahl":"1","lon":452768,"lat":5448391,"datum":"01.10.2013","titel_deutsch":"Herbst-Mosaikjungfer","titel_wissenschaftlich":"Aeshna mixta","foto":"https://berlin.artenfinder.net/afsp/multimedia/foto/sb/2013/10/01/50180093_1.jpg"},…],"next":"https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=json&cursor=50180203"}
Beispiel: Abfrage von Sichtbeobachtungen beantwortet in XML HTTP GET XML Ohne Authentifizierung
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml
Link
Antwort
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xml><result><row><id>50180093</id><bereich>Öffentliche Meldungen</bereich><status>Freigegeben</status><anzahl><![CDATA[1]]></anzahl><lon>452768</lon><lat>5448391</lat><datum>01.10.2013</datum><titel_deutsch>Herbst-Mosaikjungfer</titel_deutsch><titel_wissenschaftlich>Aeshna mixta</titel_wissenschaftlich><foto>https://berlin.artenfinder.net/afsp/multimedia/foto/sb/2013/10/01/50180093_1.jpg</foto></row>…</result><next><![CDATA[https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?format=xml&cursor=50180203]]></next></xml>
Suchen (nach Sichtbeobachtungen)
Schnittstellendefinition unter Sichtbeobachtungen > Abfragen (der Liste der Sichtbeobachtungen).
Beispiel: Suche nach Sichtbeobachtungen HTTP GET JavaScript (JSONP) Ohne Authentifizierung
- der Art "Milvus milvus - Rotmilan"
- gemeldet im Jahr 2011
- im Suchraum um Kaiserslautern (Bounding Box = 405188, 5474383, 415905, 5480017)
- begrenzte Rückgabe auf die ID, die geographischen Koordinaten und die Anzahl
- mittels JSONP in Funktion myResponseFunc()
https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?titel_wissenschaftlich=milvus milvus&jahr=2011&bbox=405188,5474383,415905,5480017&restrict=id,lat,lon,anzahl&callback=myResponseFunc
Link
Antwort
myResponseFunc({"result":[{"id":37062223,"lon":412612,"lat":5479349,"anzahl":"1"},…],"next":"https://berlin.artenfinder.net/api/v2/sichtbeobachtungen?cursor=37226794&titel_wissenschaftlich=milvus milvus&jahr=2011&bbox=405188,5474383,415905,5480017&restrict=id,lat,lon,anzahl"});
Veröffentlichen (einer eigenen Sichtbeobachtung)
Schnittstelle: https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/:id
Rechteverwaltung
Die Berechtigung zur Veröffentlichung ist beschränkt auf den Autor einer Sichtbeobachtung.
Methoden:
- PUT Authentifizierung erforderlich
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
Datenfelder
- bereich
- Ob zu veröffentlichende oder in den privaten Bereich einzuordnende Erfassung
- Datentyp: String
- Auswahlwerte:
- privat
- Sichtbeobachtung wird eingestellt in den privaten Bereich des authentifizierten Nutzers
- oeffentlich
- Sichtbeobachtungen wird eingestellt in den öffentlichen Bereich
optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
Antwort (bei erfolgreicher Bearbeitung):
HTTP/1.1 200 OK
Antwort (bei zwar authentisierter jedoch unberechtigter Anfrage):
HTTP/1.1 403 Forbidden
Vorlage: Authentifizierte PUT Anfrage HTTP PUT Mit Authentifizierung
PUT /api/v2/sichtbeobachtungen/325627 HTTP/1.1
Host: berlin.artenfinder.net
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Content-Type: multipart/form-data; charset=utf-8; boundary=--------------------31063722920652
------------------------------31063722920652
Content-Disposition: form-data; name="bereich"
oeffentlich
-----------------------------31063722920652--
Einige Umgebungen unterstützen u.U. die REST Methode PUT nicht, oder die Umsetzung ist schwierig. Hierfür erlaubt der Webservice Methoden im Header zu überladen. Verwenden Sie in einem solchen Fall POST und übergeben im Header in X-HTTP-Method-Override die gewünschte Methode PUT.
Vorlage: Authentifizierte PUT Anfrage über POST senden HTTP PUT (OVERRIDING POST) Mit Authentifizierung
POST /api/v2/sichtbeobachtungen/34435 HTTP/1.1
Host: berlin.artenfinder.net
X-HTTP-Method-Override: PUT
X-Auth-User: jdoe
X-Auth-Token: pndVpURTRaREkz
Content-Type: multipart/form-data; charset=utf-8; boundary=--------------------31063722920652
------------------------------31063722920652
Content-Disposition: form-data; name="bereich"
oeffentlich
-----------------------------31063722920652--
Eine authentifizierte Veröffentlichung einer Sichtbeobachtung mittels cURL
Beispiel: Authentifizierte Veröffentlichung einer Sichtbeobachtung in der Kommandozeile mittels cURL cURL HTTP PUT Mit Authentifizierung
curl -i -H "X-Auth-User: jdoe" -H "X-Auth-Token: pndVpURTRaREkz" -H "Content-Type: multipart/form-data; charset=utf-8" -F "bereich=oeffentlich" -X PUT https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/124561
Eine authentifizierte Veröffentlichung einer Sichtbeobachtung in PHP
Beispiel: Authentifizierte Veröffentlichung einer Sichtbeobachtung in PHP PHP HTTP PUT Mit Authentifizierung
define('MULTIPART_BOUNDARY', '--------------------------'.microtime(true));
$contents = file_get_contents( 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/34435', false, stream_context_create( array( 'http' => array(
'method' => 'PUT',
'header' => Array('X-Auth-User: jdoe', 'X-Auth-Token: pndVpURTRaREkz', 'Content-Type: multipart/form-data; charset=utf-8; boundary='.MULTIPART_BOUNDARY),
'content' =>
'--'.MULTIPART_BOUNDARY."\r\n".'Content-Disposition: form-data; name="bereich"'."\r\n\r\n".
'oeffentlich'."\r\n".
'--'.MULTIPART_BOUNDARY.'--'."\r\n"
))));
Eine authentifizierte Veröffentlichung einer Sichtbeobachtung in JavaScript
Beispiel: Authentifizierte Veröffentlichung einer Sichtbeobachtung in JavaScript / jQuery JavaScript HTTP PUT (OVERRIDING POST) Mit Authentifizierung
var data = new FormData();
data.append( 'bereich', 'oeffentlich' );
jQuery.ajax({type: 'POST', crossDomain: true, url: 'https://berlin.artenfinder.net/api/v2/sichtbeobachtungen/34435', cache: false, contentType: false, processData: false, data: data,
beforeSend: function(xhr, settings) {
xhr.setRequestHeader('X-HTTP-Method-Override', 'PUT');
xhr.setRequestHeader('X-Auth-User', 'jdoe');
xhr.setRequestHeader('X-Auth-Token', 'pndVpURTRaREkz');
}, dataType: 'json', success: function(contents) { … }});
Erweitert
Abfragen nach täglichen/stündlichen Änderungen von Sichtbeobachtungen (CREATE/UPDATE/DELETE) für inkrementellen Datenabgleich
Schnittstelle: https://berlin.artenfinder.net/api/v2/protokoll
Hinweise zum Datenabgleich
Änderungen von Sichtbeobachtungen werden in einer sequentiellen Liste abgelegt. Die Liste ist im LCFS-Prinzip („Last Come, First Served“) implementiert und protokolliert Schreiboperationen der hinterlegten Sichtbeobachtungen (CREATE/UPDATE/DELETE).
Methoden:
Parameter:
- optionale Such-/Filterparameter
- datum_von
- Auswahl beschränken auf einschliesslich ab übergebenem Bearbeitungsdatum
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- Bsp.:
https://berlin.artenfinder.net/api/v2/protokoll?format=xml&datum_von=01.01.2011
Link
- datum_bis
- Auswahl beschränken auf einschliesslich bis zum übergebenen Bearbeitungsdatum
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- Bsp.:
https://berlin.artenfinder.net/api/v2/protokoll?format=xml&datum_von=01.01.2012&datum_bis=01.02.2014
Link
- optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- limit
- Begrenzung der Ergebnisliste
- Datentyp: Integer
- Standardwert: 100
- Gültiger Wertebereich: 1 - 1000
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
- Bsp. für eine Restriktion:
https://berlin.artenfinder.net/api/v2/protokoll?format=xml&restrict=id
Link
Antwort:
- result
- row (XML) / Array (JSON)
- audit
- Typ der Bearbeitung (CREATE/UPDATE/DELETE)
- Datentyp: String
- id
- Eindeutige ID der bearbeiteten Sichtbeobachtung
- Datentyp: Integer
- datum
- Datum der Bearbeitung
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- uhrzeit
- Uhrzeit der Bearbeitung
- Datentyp: String
- Datenformat: HH:MM:SS
- next
- Ist die erhaltene Antwort limitiert, wird in next eine URL auf die fortführende Ergebnisliste/Seite aufgezeigt.
- Datentyp: String
Abfragen auf das Protokoll der Qualitätssicherung (Abgelehnt, Freigegeben, mit Hinweis versehen, In Prüfung)
Schnittstelle: https://berlin.artenfinder.net/api/v2/qs
Rechteverwaltung
Abfragen auf das Protokoll der Qualitätssicherung sind allein authentisierten Nutzern der Rolle Experte oder Administrator vorbehalten.
Hinweise zum Protokoll
Das Protokoll der Qualitätssicherung wird in einer sequentiellen Liste abgelegt. Die Liste ist im LCFS-Prinzip („Last Come, First Served“) implementiert.
Methoden:
- GET Authentifizierung erforderlich
Header (
für Authentifizierung):
- X-Auth-User
- Loginname des Nutzers in Klartext
- Datentyp: String
- X-Auth-Token
- Zugriffsschlüssel
- Datentyp: String
Parameter:
- optionale Such-/Filterparameter
- datum_von
- Auswahl beschränken auf einschliesslich ab übergebenem Statusänderungsdatum
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- datum_bis
- Auswahl beschränken auf einschliesslich bis zum übergebenen Statusänderungsdatum
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- uid
- Auswahl beschränken auf Statusänderungen zu eindeutiger Erfasser-ID
- Datentyp: Integer
- status_aenderung
- Auswahl nach Statusänderung der SB
- Datentyp: String
- Auswahlwerte:
- freigegeben
- Sichtbeobachtung freigegeben
- pruefung
- Sichtbeobachtung in Prüfung
- abgelehnt
- Sichtbeobachtung abgelehnt
- hinweis
- Sichtbeobachtung mit Hinweis versehen
- optionale Parameter
- format
- Definition des Ausgabeformates
- Datentyp: String
- Standardwert: json
- Auswahlwerte: json, xml
- callback
- Definition einer JavaScript Funktion zur Rückgabe mittels JSONP
- Datentyp: String
- limit
- Begrenzung der Ergebnisliste
- Datentyp: Integer
- Standardwert: 100
- Gültiger Wertebereich: 1 - 1000
- restrict
- Datenausschnitt der Antwort
- Datentyp: String
Antwort:
- result
- row (XML) / Array (JSON)
- id
- Eindeutige ID der Sichtbeobachtung
- Datentyp: Integer
- uid
- Eindeutige Erfasser-ID der Sichtbeobachtung
- Datentyp: Integer
- datum
- Datum der Statusänderung
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- uhrzeit
- Uhrzeit der Statusänderung
- Datentyp: String
- Datenformat: HH:MM:SS
- status_aenderung
- Statusänderung der Erfassung. Ob Freigegeben, in Prüfung, mit Hinweis versehen oder Abgelehnt
- Datentyp: String
- aid
- datum_beobachtung
- Datum der Sichtbeobachtung
- Datentyp: String
- Datenformat: TT.MM.JJJJ
- experte_uid
- Eindeutige Benutzer-ID des Experten bei Freigabe oder Ablehnung der Sichtbeobachtung
- Datentyp: Integer
- next
- Ist die erhaltene Antwort limitiert, wird in next eine URL auf die fortführende Ergebnisliste/Seite aufgezeigt.
- Datentyp: String
Änderungsprotokolle der Web Service API
Änderungsprotokoll vom 03.02.2014, Version 2.0.6
- Art der Änderung: Anpassung
- Anpassung einiger Beispiellinks der Dokumentation da Artengruppen seit dem 24.01.2014 mit Umlauten hinterlegt sind.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 06.02.2014, Version 2.0.7
Änderungsprotokoll vom 07.02.2014, Version 2.0.8
- Art der Änderung: Korrektur
- Korrektur der geographischen Koordinaten zu Sichtbeobachtungen, Wechsel der Lat <-> Lon Koordinatenpaarzuweisung.
- Bearbeitungsstatus: berichtigt
Änderungsprotokoll vom 24.04.2014, Version 2.0.9
- Art der Änderung: Erweiterung
- Erweiterte JavaScript Beispiele zur Dokumentation von Cross-Domain Meldungen / Bearbeitungen der Sichtbeobachtungen / Nutzer und erweiterter Login Beispielquelltext.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 29.04.2014, Version 2.0.10
Änderungsprotokoll vom 05.06.2014, Version 2.0.11
- Art der Änderung: Korrektur
- Korrektur der Authentifizierung (X-Auth-User, X-Auth-Token) in UTF-8-Kodierung.
- Bearbeitungsstatus: berichtigt
Änderungsprotokoll vom 18.08.2014, Version 2.0.12
- Art der Änderung: Korrektur
- Korrektur der geographischen Koordinaten zur Meldung von Sichtbeobachtungen.
- Bearbeitungsstatus: berichtigt
Änderungsprotokoll vom 22.09.2014, Version 2.0.13
- Art der Änderung: Anpassung
- Abbildung eines gültigen Wertebereiches für das Datenfeld "Anzahl" bei Meldung von Sichtbeobachtungen.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 22.09.2014, Version 2.0.14
- Art der Änderung: Erweiterung
- Eine um die eindeutige OSIRIS Art-ID des Landesinformationssystems Rheinland-Pfalz erweiterte Antwort der Liste der Sichtbeobachtungen.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 01.10.2014, Version 2.0.15
- Art der Änderung: Erweiterung
- Erweiterung zur Meldung und Nachbearbeitung einer Sichtbeobachtung um einen optionalen "Spatial Reference Identifier (SRID)"
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 20.02.2015, Version 2.0.16
- Art der Änderung: Erweiterung
- Eine um den Phänogramm-Status erweiterte Antwort der Listen und Detailanfrage der Sichtbeobachtungen.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 07.12.2016, Version 2.0.17
- Art der Änderung: Anpassung
- Anpassung der Dateigrößenbegrenzung von Mediendateien (Foto) einer Sichtbeobachtung von 0,5 MB auf 6 MB - wird intern auf weniger als 500 KB komprimiert.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 23.05.2017, Version 2.0.18
- Art der Änderung: Erweiterung
- Anpassung der Ausgabe von geographischen Koordinaten für naturschutzfachlich sensible Arten. Koordinaten werden für naturschutzfachlich sensible Arten nicht exakt, sondern als Mittelpunkt des UTM 32 K10 Rasters ausgegeben. Ausgenommen hiervon sind Nutzer der Rollen Administrator, Experte und Eigentümer der abgerufenen Sichtbeobachtung.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 01.06.2017, Version 2.0.19
- Art der Änderung: Erweiterung
- Erweiterung der Ausgabe von geographischen Koordinaten für naturschutzfachlich sensible Arten um eine mandantenabhängige, regionale Referenzierung (z.B. Naturschutzfachlich sensible Arten nach Bundesland). Zudem wird das Ausgabeattribut "is_rasterized" in der Auflistung und Detailantwort der Sichtbeobachtungen eingeführt und gibt Auskunft ob eine Rasterung der Sichtbeobachtung als Mittelpunkt des UTM 32 K10 Rasters aufgrund einer regional naturschutzfachlich sensiblen Art vorgenommen werden musste.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 24.08.2017, Version 2.0.20
- Art der Änderung: Anpassung
- Die Header-Authentifizierung über einen X-Auth-Token wird in aktuellen Firefox Versionen von CamelCase in Großschreibung überführt. Anpassung der API an dieses Verhalten.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 20.11.2018, Version 2.0.21
- Art der Änderung: Erweiterung
- Das ArtenFinder Service Portal ist erweitert um eine optionale Nutzerkonteneinstellung zur Anonymisierung. Nutzernamen zu Meldungen von Sichtbeobachtungen durch anonymisierte Nutzerkonten werden in der Webservice API nicht weiter im Klarnamen sondern teilanonymisiert ausgegeben. Hierfür wird jeweils nur der Anfangsbuchstabe des Vor- und Nachnamens verwendet (so wird z.B. Hans Mustermann zu H... M...). Authentifizierte Abfragen durch Experten oder Administratoren erhalten weiterhin den vollständigen Klarnamen der Erfasser. Anpassung der API (Sichbeobachtungen, Nutzer, Registrierung) an dieses Verhalten.
- Bearbeitungsstatus: erweitert
Änderungsprotokoll vom 26.11.2018, Version 2.0.22
- Art der Änderung: Anpassung
- Anpassung der Ausgabe von geographischen Koordinaten für naturschutzfachlich sensible Arten. Koordinaten werden für naturschutzfachlich sensible Arten nicht als Mittelpunkt eines 10x10km², sondern eines 2x2km² Rasters ausgegeben.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 16.08.2019, Version 2.0.23
- Art der Änderung: Korrektur
- Korrektur der Anfrage zu Sichtbeobachtungen, die Einträge, aufgrund der Änderungen vom 23.05.2017 zu naturschutzfachlich sensiblen Arten, wiederholt auflistete, wenn Koordinaten auf Grenzen des hinterlegten UTM 32 K10 Rasters trafen.
- Bearbeitungsstatus: berichtigt
Änderungsprotokoll vom 23.08.2019, Version 2.0.24
- Art der Änderung: Korrektur
- Korrektur der Anfrage zu Sichtbeobachtungen. Bei Angabe des optionalen Such-/Filterparameters ob Pflanzen- oder Tierart ("is_animal") wurde in der URL auf die fortführende Ergebnisliste/Seite dieser Parameter als Zahlenwert weitergereicht.
- Bearbeitungsstatus: berichtigt
Änderungsprotokoll vom 28.02.2020, Version 2.0.25
- Art der Änderung: Erweiterung
- Das ArtenFinder Service Portal ist erweitert um eine Ausgabe des bearbeitenden Experten bei Freigabe oder Ablehnung einer Sichtbeobachtung. Diese Erweiterung betrifft die Abfragen auf das Protokoll der Qualitätssicherung (Abgelehnt, Freigegeben, In Prüfung).
- Bearbeitungsstatus: erweitert
Änderungsprotokoll vom 28.02.2020, Version 2.0.26
Änderungsprotokoll vom 02.07.2020, Version 2.0.27
- Art der Änderung: Erweiterung
- Abfragen der Artenliste im ArtenFinder Service Portal sind erweitert um die Ausgabe von Mandanten-spezifischen Artdefinitionen, z.B. OSIRIS / ONeo Artdefintion des Landesinformationssystems Rheinland-Pfalz, Hessen oder Stiftung Naturschutz Berlin (Mandanten-spezifische Art-ID, naturschutzfachlich sensible Art, wiss. und deutscher Artname).
- Bearbeitungsstatus: erweitert
Änderungsprotokoll vom 02.07.2020, Version 2.0.28
- Art der Änderung: Erweiterung
- Abfragen der Sichtbeobachtungen im ArtenFinder Service Portal sind erweitert um die Ausgabe von Mandanten-spezifischen Artdefinitionen, z.B. OSIRIS / ONeo Artdefintion des Landesinformationssystems Rheinland-Pfalz, Hessen oder Stiftung Naturschutz Berlin (Mandanten-spezifische Art-ID, wiss. und deutscher Artname).
- Bearbeitungsstatus: erweitert
Änderungsprotokoll vom 03.08.2020, Version 2.0.29
- Art der Änderung: Erweiterung
- Der Status der Sichtbeobachtungen im ArtenFinder Service Portal ist erweitert um den Status "Hinweis". Sichtbeobachtungen mit diesem Status gelten als bedingt geprüft, sind jedoch nicht endgültig freigegeben und veröffentlicht und nur für angemeldete Nutzer sichtbar.
- Bearbeitungsstatus: erweitert
Änderungsprotokoll vom 19.09.2020, Version 2.0.30
- Art der Änderung: Erweiterung
- Einzelne Sichtbeobachtungen können als sensible Beobachtungen hinterlegt werden. Sensible Sichtbeobachtungen werden wie Sichtbeobachtungen regional naturschutzfachlich sensibler Arten behandelt und die Verortung der Beobachtung im AFSP nicht exakt, sondern als Mittelpunkt eines 2x2km² Rasters ausgegeben.
- Bearbeitungsstatus: erweitert
Änderungsprotokoll vom 23.02.2021, Version 2.0.31
- Art der Änderung: Anpassung
- Anpassung der Dateigrößenbegrenzung von Mediendateien (Foto) einer Sichtbeobachtung von 6 MB auf 12 MB - wird intern auf weniger als 500 KB komprimiert.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 26.03.2021, Version 2.0.32
- Art der Änderung: Erweiterung
- Die Ausgaben der Sichtbeobachtungen im ArtenFinder Service Portal sind erweitert um die Angabe der durch den Melder vorgenommenen Markierung als sensible Sichtbeoachtung.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 26.03.2021, Version 2.0.33
- Art der Änderung: Erweiterung
- Die Bemerkung des Experten zur Sichtbeobachtung ist in die Ausgabe der Sichtbeobachtungen aufgenommen.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 09.04.2021, Version 2.0.34
- Art der Änderung: Anpassung
- Erweiterung der max. Dateigröße für Audiodateien auf 1 MB. Zusätzlich ist die Beschränkung auf den Medientypen
- .mp3 (MPEG Audio Layer III)
aufgehoben, so daß auch Audioformate wie
- .amr/.awb (Adaptive Multi-Rate (AMR, AMR-NB)),
- .flac (Free Lossless Audio Codec (FLAC)),
- .m4a (M4A Audio-MPEG-4 / Apple Lossless Audio Codec (ALAC)),
- .oga (Ogg Vorbis Audio File (OGA)),
- .wav (Waveform Audio File Format (WAVE)) oder
- .aac (Advanced Audio Coding (AAC))
einer Beobachtung hinterlegt werden können.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 27.07.2021, Version 2.0.35
- Art der Änderung: Erweiterung
- Die Ausgabe der Sichtbeobachtungen ist um eine eindeutige GUID (Universally Unique Identifier (UUID) in Version 5) erweitert.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 02.08.2021, Version 2.0.36
- Art der Änderung: Erweiterung
- Die Übermittlung neuer Sichtbeobachtungen ist um eine Prüfung ergänzt, welche Einträge über die Parameter Artreferenz, Koordinate und Datum mit bestehenden Meldungen des Nutzers abgleicht und bei Anlage von Duplikaten die Erstellung abbricht.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 10.03.2023, Version 2.0.37
- Art der Änderung: Anpassung
- Anpassung der Ausgabe von geographischen Koordinaten für naturschutzfachlich sensible Arten. Koordinaten werden für naturschutzfachlich sensible Arten nicht als Mittelpunkt eines 2x2km², sondern eines 5x5km² Rasters ausgegeben.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 10.04.2024, Version 2.0.38
- Art der Änderung: Erweiterung
- Erweiterung der Sichtbeobachtungen um die optionalen Zusatzparameter Entwicklungsstadium und Aktivitätstyp.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 12.06.2024, Version 2.0.39
- Art der Änderung: Erweiterung
- Aufnahme der Auskunft ob regional (bzw. mandantenspezifisch), naturschutzfachlich sensible Art in die Ausgabe der Sichtbeobachtungen.
- Bearbeitungsstatus: aktualisiert
Änderungsprotokoll vom 30.09.2024, Version 2.0.40
- Art der Änderung: Erweiterung
- Aufnahme der ArtenInfo-Artenportraits in den Ausgaben der Details einer Art.
- Bearbeitungsstatus: aktualisiert
FAQ
Keine Einträge vorhanden.
Impressum
Anbieter
Landesamt für Umwelt, Wasserwirtschaft und Gewerbeaufsicht Rheinland-Pfalz
Informations- und Kommunikationstechnik
Kaiser-Friedrich-Straße 7
55116 Mainz
Telefon: 06131 60330
Mail: poststelle(at)luwg.rlp.de
Technische und fachliche Umsetzung
u-werk, Umweltinformationsdienste
www.u-werk.net, info(at)u-werk.net