API

Last updated: am 15.06.2020 um 11:09 Uhr by Egotec, live

Aufruf

Sie benötigen die gewünschte Methode (method) und Ihren API Key (key) diesen fordern Sie bitte unter support@saas.de an.

Antwort

Alle API-Aufrufe liefern Ihnen ein JSON Objekt zurück.

Beispiele

mit PHP

<?php
$url = "https://saas-de.appspot.com/json/api";
$ch = curl_init();
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, "method=come&email=mail@egotec.com&key=aaaaaaaaaaaaaaaaaaaaaa");
curl_setopt($ch, CURLOPT_POST, count(1));
curl_setopt($ch, CURLOPT_HTTPHEADER,
array( "Content-Type: application/x-www-form-urlencoded; charset=utf-8", )
);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
?>

mit JavaScript

<!DOCTYPE html>
<html>
<head>
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js">
</script>
<script>
		function post(data, onsuccess, onerror) {
			var url = "https://saas-de.appspot.com/json/api";
			$.ajax({
				url : url,
				type : "POST",
				data : data,
				success : function(data) {
					if (data != null && typeof data == "string") {
						data = JSON.parse(data);
					}
					onsuccess(data);
				},
				error : function() {
					if (onerror == null) {
						console.log("error");
					} else {
						onerror();
					}
				}
			});
		}
		
		function run() {
			post({
				method : "come",
				email : "mail@egotec.com",
				key : "aaaaaaaaaaaaaaaaaaaaaa"
			}, function() {
				console.log("ja")
			}, function() {
				console.log("nein")
			});
		}
</script>
</head>
<body>
	<button onclick="run()">Try it</button>
</body>
</html>

mit Java

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

public class Servlet {

public static void main(String customer, String project) throws Exception {

// Feste Parameter
String urlString = "https://saas-de.appspot.com/json/api";

// kann sich noch ändern, ist aber vorerst noch fest
String key = "aaaaaaaaaaaaaaaaaa";

// ein Mitarbeiter der in SaaS.de existiert
String account = "mail@egotec.com";

String body = "aa=" + URLEncoder.encode("aa", "UTF-8")
+ "&" + "method=" + URLEncoder.encode("createProject", "UTF-8")
+ "&" + "email=" + URLEncoder.encode(account, "UTF-8")
+ "&" + "key=" + URLEncoder.encode(key, "UTF-8")
+ "&" + "customer=" + URLEncoder.encode(customer, "UTF-8")
+ "&" + "project=" + URLEncoder.encode(project, "UTF-8");

URL url = new URL(urlString);
HttpURLConnection connection = (HttpURLConnection)
url.openConnection(); connection.setRequestMethod("GET");
connection.setDoInput(true); connection.setDoOutput(true);
connection.setUseCaches(false);
connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
connection.setRequestProperty("Content-Length",
String.valueOf(body.length())); OutputStreamWriter writer = new OutputStreamWriter(connection.getOutputStream()); writer.write(body);
writer.flush(); BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));

for (String line; (line = reader.readLine()) != null;) {
System.out.println(line); } writer.close(); reader.close();
}
}

Fehlercodes

  ERROR_CODE	DESC
  0			Alles OK
  1			Mitarbeiter nicht gefunden
  2			Firma nicht aktiv
  3			Falsche Authentifizierung‎
  4			Buchung konnte nicht erstellt werden
  5			Methode gibt es nicht
  6			Keine Methode übergeben