Eine API-POST-Anforderung (auch als HTTP-POST-Anforderung bekannt) ist eine API-Transaktion, bei der der API-Anforderer Daten an den API-Anbieter übermittelt, um eine vorhandene API-Ressource zu aktualisieren, zu erstellen oder zu löschen. API-POST-Anforderungen werden in der Regel verwendet, wenn eine bestimmte API-Ressource durch Senden von Daten an den API-Anbieter erstellt, aktualisiert oder gelöscht werden muss. Ein Beispiel für eine API-POST-Anforderung ist das Senden eines Koordinatensatzes an den API-Anbieter bei UnwiredLabs.
UnwiredLabs verfügt über eine API, die Koordinatendaten auf der Grundlage von Mobilfunk-/WiFi-Daten bereitstellt. Mithilfe einer API-POST-Anfrage können Entwickler Koordinaten an die API übermitteln, und es wird ein vollständiger Geolokalisierungsdatensatz zurückgegeben. Eine API-POST-Anfrage könnte zum Beispiel so aussehen:
POST https://unwiredlabs.com/v2/process.php
{
"token": "YOUR_TOKEN_HERE",
"wifi": [
{
"signal": -67,
"key": "abcd4567891123456"
},
{
"key": "dfe5447678911234",
"signal": -64
}
],
"address": 1
}
In diesem Beispiel sendet die API-POST-Anfrage an die UnwiredLabs-API eine Reihe von WLAN-Zugangspunkten zusammen mit einem Booleschen Wert, der angibt, ob Adressinformationen in die Antwort aufgenommen werden sollen oder nicht. Die API gibt dann einen vollständigen Geolokalisierungsdatensatz zurück, der Breitengrad, Längengrad, Höhe und Genauigkeit enthält.