====== Webservices ======

Bei Bedarf steht sowohl eine SOAP wie auch eine JSON-RPC Schnittstelle zur Verfügung um Daten aus taginet von Fremdsystemen aus abzurufen. 

===== SOAP =====
Der Zugriffspunkt lautet: https://www.taginet.com/KRIPPENNAME/soap.php .

Zugehörige WSDL-Datei: https://www.taginet.com/KRIPPENNAME/soap.php?wsdl


===== JSON-RPC =====
Der Zugriffspunkt lautet: https://www.taginet.com/KRIPPENNAME/json-rpc.php

Die SMD-Datei kann mittels GET unter obiger URL abgerufen werden.



===== Konfiguration =====
Die Benutzung der Webservices muss zunächst durch die Centerboard AG freigeschaltet werden:
  * //api_enabled// wird in der Konfiguration auf //Ja// gesetzt
  * Die Benutzer welche mittels API zugreifen möchten müssen die Berechtigungsgruppe //Webservices// eingeteilt werden.
Die berechtigten Benutzer erstellen dann selbstständig unter "Mein tagiNet" / "API-Key" einen individuellen API-Schlüssel.

===== Funktionen =====

Momentan existieren folgende Funktionen:

==== getKinder ====

   * Grunddaten sämtlicher Kinder
   * Argumente: 
      * 'key' (API-Key zwingend)

==== getEmails ====

   * E-Mails der zum heutigen Tag aktiven Vertragspartner
   * Argumente: 
      * 'key' (API-Key zwingend)

==== getVertragspartner ====

   * Listet alle (oder den einen) Vertragspartner plus zugehörige Kinder (mit Monatsbeitrag Kind) in einem mehrdimensionalen Array 
   * Argumente: 
      * 'key' (API-Key zwingend), 
      * 'elternid' (technische ID der Vertragspartner in tagiNet; wenn nicht angegeben, dann werden alle Eltern aufgelistet)
   
==== getKontostand ====

   * Gibt den aktuellen Kontostand (Stand heute) als Float zurück
   * Argumente: 
       * 'key' (API-Key zwingend), 
       * 'elternid' (technische ID der Vertragspartner in tagiNet; zwingend)
   
==== getKontoauszug ====

   * Listet alle Kontobewegungen einer Familie in einem mehrdimensionalen Array
   * Argumente: 
      * 'key' (API-Key zwingend), 
      * 'elternid' (technische ID der Vertragspartner in tagiNet; zwingend)