Forum

Sehr geehrte Damen und Herren,

auf Ihrer Webseite https://www.gpsauge.de finde ich unter dem Menüpunkt:
Anbindung --> API --> Öffentliche Module --> Devices, Fahrzeugortung und
Status --> mehr Infos
--> Abrufen der Position inkl. Fahrer und Status
(mode=cars|contacts|positions)

folgende Programme
php:
<?php
include("./include/gpsapi/apiutils.php";
$arr = array();
$arr["module"] = "devices";
$arr["action"] = "get";
$arr["user"] = "user";
$arr["pwd"] = "geheim";
$arr["mode"] = "positions";
$arr["deviceid"] = "213059";
$arr["nameonly"] = "0";
$arr["format"] = "json";
$arr["plainpos"] = "1";
$result = apiGetData($arr);
$result = apiUnzip($result);
if (apiReturn($result))
echo "SUCCESS!";
else
echo "ERROR";
7?>

Die 1. Zeile im php Programm lautet
include("./include/gpsapi/apiutils.php";
Es fehlt jedoch die Datei apiutils.php. Diese ist in der php
Installation nicht vorhanden und auch im Internet nicht zu finden.

Auf Ihrer Webseite lese ich:
Aufbau der API-Anforderungen
"In der Dokumentation finden Sie die Beschreibung der einzelnen Module,
deren Aktionen und die möglichen Parameter, die Sie bei der Entwicklung
zur Verfügung haben. Dabei sind bei jedem Modul Code-Beispiele,
Antworten des Gateways und mögliche Fehlermeldungen beschrieben."

Wo finde ich diese Dokementation? Wo ist die Datei apiutils.php?

Das c# Beispiel sieht wie folgt aus:

using System;
using System.Windows.Forms;
using System.Collections;

namespace API_cs
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}

private void button1_Click(object sender, EventArgs e)
{
api_utils API = new api_utils();
Hashtable arr = new Hashtable();
string result;
arr.Add("module", "devices";
arr.Add("action", "get";
arr.Add("user", "user";
arr.Add("pwd", "geheim";
arr.Add("mode", "positions";
arr.Add("deviceid", "213059";
arr.Add("nameonly", "0";
arr.Add("format", "json";
arr.Add("plainpos", "1";
result = API.apiGetData(arr);
if (result == ""
{
result="return:=-1";
}
else
{
MessageBox.Show(API.apiUnzip(result));
}
}
}
}

In der Zeile
api_utils API = new api_utils();
erhalte ich die Fehlermeldung:
The type or namespace name 'api_utils' could not be found (are you
missing a using directive or an assembly reference?)
Diese Meldung ist nicht weiter verwunderlich, da eine Referenz zu einer
Library fehlt. Die Library heißt api_utils.
Diese ist entweder eine dll oder ich kompiliere die dll selbst, wenn ich
den Quellcode habe.
Beides finde ich bei Ihnen auf der Webseite nicht.

Zusammenfassung:

Wie komme ich an die api Schnittstellen Beschreibung und die Dateien
apiutils.php (mit sämtlichen Abgängigkeiten) und die Datei api_utils.dll
oder den c# Quellcode?

Ist die c# Library eine .net Anwendung mit .net Framework 4.8 oder eine
.net Core Anwendung mit .net Core 6.0 (long term support)?

Mit freundlichen Grüßen

Steffen

Guten Tag Herr Steffen,
vielen Dank für Ihre Anfrage bezüglich der Hilfsbibliothek "apiUtils"!

Genaugenommen benötigen Sie diese nicht. Unsere, auf der Webseite beschriebene, API kann ganz einfach über HTTP-GET Requests mit entsprechenden Request-Parametern (z.B. module, action, user, device, ...) aufgerufen werden.

Die apiUtils kapselt lediglich den HTTP-Aufruf in der jeweiligen Programmiersprache (z.B. via CURL im Fall von PHP). Eine Beispiel-URL wäre z.B.:

https://www.apioverip.de/?module=devices&action=list&user=[IHR_GPS-ACCOUNT]&pwd=[IHR_GPS_ACCOUNT_PASSWORT]&nozlib=1&format=json

(Bitte beachten Sie die Platzhalter in eckigen Klammern, die natürlich entsprechend ersetzt werden müssen.)

Diese URL liefert eine Liste aller im GPS-Account registrierten GPSaugen.

Parameter-Tipp:
- nozlib=1|0 aktiviert/deaktiviert die GZip-Komprimierung der Antwort
- format=json liefert die Antwort im Ausgabeformat JSON

Beste Grüße,
Ihr Entwicklungs-Team der GPSoverIP GmbH.