header-l pixel_trans
pixel_trans btn_l4n_neu_110x76_gratis pixel_trans btn_l6ha_neu_200x138 pixel_trans btn_l5ha_200x138 pixel_trans btn_pkt_200x138 pixel_trans paypal sofortueberweisung payment_paypal_sofortueberweisung pixel_trans
   
pixel_trans pixel_trans pixel_trans
flagpixel_transflag
pixel_trans
pixel_transmarker3 Home
pixel_transmarker3 Hotspot-L4N
pixel_transmarker3 Hotspot-L4N::Download
pixel_transmarker3 Hotspot-Appliance::L5HA
pixel_transmarker3 Hotspot-Appliance::L6HA
pixel_transmarker1 Info
pixel_transmarker1 L4Net
pixel_transmarker3 Internetzugang-L4
pixel_transmarker3 OnDemand-Codes-L4
pixel_transmarker3 Stats-L4
pixel_transmarker3 Vouchers-L4
pixel_transmarker3 Views-L4
pixel_transmarker3 SMSAuth-L4
pixel_transmarker1 Sale-L4
pixel_transmarker3 PayPal-L4
pixel_transmarker3 WorldPay-L4
pixel_transmarker3 Sofortüberweisung-L4
pixel_transmarker3 Bill4Net-L4
pixel_transmarker3 2Checkout-L4
pixel_transmarker3 Authorize.Net-L4
pixel_transmarker3 ClickandBuy-L4
pixel_transmarker3 VPN Routing-L4
pixel_transmarker3 WebAdmin-L4
pixel_transmarker3 Adverts-L4
pixel_transmarker3 Monitor-L4
pixel_transmarker4 Webservice-L4(SOAP)
pixel_transmarker3 Roaming
pixel_transmarker3 Leistungen-L4
pixel_transmarker1 Hotspot-L4
pixel_transmarker1 Hotspotbetreiber
pixel_transmarker1 Partner
pixel_transmarker1 Hotspotnutzer
pixel_transmarker3 Dokumente
pixel_transmarker3 Rechtliche Aspekte
pixel_transmarker3 Shop
pixel_transmarker3 Kontakt
pixel_transmarker3 Newsletter
pixel_transmarker3 Suchen
pixel_transmarker3 Referenzen
pixel_transmarker3 Kompetenzen
pixel_transmarker3 Service+Support
pixel_transmarker3 Impressum
 
pixel_trans
News
04.05.12 Neues Zahlungsmodul BILL4NET - Micropayment über die Telefon- oder Mobilfunkrechnung. →mehr
01.08.11 Produktneuheit L4N
Der Wireless-N Gigabit Hotspot-L4N/L4Net für TP-LINK TL-WR1043ND ist der Nachfolger unseres Erfolgsmodells Hotspot-L4 mit Ticketdrucker, UMTS-Router uvm. →mehr
24.09.10 SMSAuth-L4 - Sichere Benutzeridentifikation und Anmeldung per Mobilfunk-SMS →mehr
03.06.10 Produktneuheit L6HA
Hotspot Komplettlösung L6HA Premium (Dualband Wireless-N Gigabit Hotspot-L6)
Die All-in-One Komplettlösung
Gateway, Server, AP, SSL, PayPal, VPN, Web-Filter uvm.
04.02.10 Neues Zahlungsmodul ClickandBuy →mehr
19.11.09 Neues Zahlungsmodul Kreditkartenzahlung (Authorize.Net) →mehr
16.11.09 Neues Verkaufsmodul 2Checkout (Kreditkarten, PayPal) →mehr
05.11.09 Neues Zahlungsmodul Kreditkartenzahlung (WorldPay) →mehr
06.08.09 Betrieb aller Online-Systeme auf einem ausfallsicheren Hochleistungs/Hochverfügbarkeits- Cluster
04.08.09 L4/L5HA: Proaktiver Betreiberschutz durch VPN-Routing verfügbar
04.03.09 L5HA: UMTS- Option verfügbar →mehr.
22.01.09 Neues Zahlungsmodul sofortüberweisung.de →mehr
16.12.08 L5HA: Ticketdrucker- Option verfügbar →mehr.
12.06.08 Produktneuheit L5HA
Hotspot Komplettlösung L5HA
Die All-in-One Komplettlösung
Gateway, Server, AP, SSL, PayPal, VPN, Web-Filter uvm.
14.03.08 'Hotspot-L4'-Firmware: Version 7.8.4 verfügbar: Verbesserte PayPal-Unterstützung durch automatische Anpassung an wechselnde PayPal-IP's.
05.02.08 Vouchergenerierung: OIDs und EAN13-Barcodedruck
04.02.08 Codeverwaltung: Umfangreiche Such-, Filter-, Sortier- und Aktionsmöglichkeiten
19.11.07 L4CC-SO(Portable) Version 3.4 verfügar →mehr
16.11.07 'Hotspot-L4'-Firmware: Version 7.8 verfügbar →mehr
20.08.07 'Hotspot-L4'-Firmware: Version 7.7 verfügbar →mehr
20.07.07 L4CC-SO(Portable) für Linux(neu) und MS-Windows verfügar →mehr
28.06.07 Verbessertes Portalsystem
27.06.2007 Vollständige Unterstützung internationaler Zeichensätze(UTF-8) bei der Generierung von PDF-Vouchern →mehr
24.06.07 WiooaVPN - VPN-Sicherheit im WLAN →mehr
29.05.07 Sprachunterstützung Russisch →Live-Demo
02.04.07 Abrechnung in 173 Währungen →mehr
pixel_trans

L4Net::Webservice-L4(SOAP)

Mit 'L4Net::Webservice-L4(SOAP)' erhalten Sie die Freiheit die Funktionalität der L4Net-Dienste in eigene Projekte (Hotelsoftware, Payment-Gateways für z.B. Kreditkartenzahlung oder PayPal, ...) zu integrieren.

Einführung

Webservices sind eine moderne und populäre Technologie. SOAP(Simple Object Access Protocol) als deren wichtigster Vertreter ist ein XML-basiertes Protokoll zum Austausch strukturierter Informationen zwischen verteilten Applikationen über native Webprotokolle wie z.B. HTTP. SOAP spezifiziert das Format welches XML-Messages benutzen, die Art in welcher diese verarbeitet werden sollen, Codierungsregeln für Datentypen und Konventionen zur Repräsentation von 'Remote Procedure Calls(RPC)' und Responses. Entsprechende Implementierungen stehen in allen gängigen Programmiersprachen zur Verfügung.

Das folgende Beispiel (in PHP-5.1) verdeutlicht die einfache Nutzung:

Schritt 1 - Erzeugen eines SoapClients:
$client = new SoapClient("http://www.wimondo.com/webservice/L4WebService.wsdl", array("login"=>"myname", "password"=>"mypassword");
Schritt 2 - Aufruf einer Funktion:
$account = $client->createAccount("U99999999:timewindow:1d");
Schritt 3 - Weiterverarbeitung:
echo $account->code;

Funktionsbeschreibung:

Name: getAccount
Parameter: Code(S)
Rückgabe: AccountObjekt
Fehlercodes: 01
Beispiel(PHP-5.1): $account = $client->getAccount("av0fghj7tyxc"); echo $account->acc_fulltime;

Name: createAccount
Parameter: UID(S): Typ[time|timewindow](S):
 Zeit[15m,1h,2h,5h,10h,24h,50h|1d,1w,2w,1m,6m,1y](S)

Rückgabe: AccountObjekt
Fehlercodes: 02,03,04
Beispiel(PHP-5.1): $account = $client->createAccount("U99999999:timewindow:1d");
echo $account->code;


Name: getAccounts
Parameter: Code(S)
Rückgabe: AccountsObjekt
Fehlercodes: 02
Beispiel(PHP-5.1): $accounts = $client->getAccounts("U99999999");
foreach ($accounts->Accounts as $account) {
echo $account->code.":".$account->online_status."\n";
}


Name: actionAccount
Parameter: Code(S):Aktion[lock,unlock,disconnect,delete](S)
Rückgabe: AccountObjekt
Fehlercodes: 01,05
Beispiel(PHP-5.1): $account = $client->actionAccount("av0fghj7tyxc:delete");

Name: getGateways
Parameter: -
Rückgabe: GatewaysObjekt
Fehlercodes:
Beispiel(PHP-5.1): $gateways = $client->getGateways();
foreach ($gateways->Gateways as $gateway) {
echo $gateway->uid.":".$gateway->name."\n";
}


Name: getGatewayIsOnline
Parameter: UID(S)
Rückgabe: Boolean TRUE/FALSE
Fehlercodes: 02
Beispiel(PHP-5.1): $online= $client->getGatewayIsOnline("U99999999");
if($online) echo "online"; else echo "offline";


Name: getConnections
Parameter: Code(S)
Rückgabe: ConnectionsObjekt
Fehlercodes: 01
Beispiel(PHP-5.1): $connections = $client->getConnections("av0fghj7tyxc");
foreach ($connections->Connections as $connection) {
echo $connection->start.":".$connection->stop."\n";
}


Name: getTransactionsCount
Beschreibung: Liefert die Anzahl der über die Webserviceschnittstelle durchgeführten Transaktionen im angegebenen Berichtszeitraum zurück.
Parameter: Periode(S)[today,yesterday,thisweek,lastweek,thismonth,lastmonth]
Rückgabe: Transaktionen in der Periode(I)
Fehlercodes: 06
Beispiel(PHP-5.1): $count = $client->getTransactionsCount("thismonth");
echo "Transactions: $count";


Typen:
AccountObjekt
[code](S) Code
[online_status](I) Onlinestatus: 0=Offline, 1=Online, 3=Pending to disconnect
[acc_attr](S) Attribut
[acc_mode](S) Accounttyp: time | timewindow
[acc_ctime](I) Erzeugungszeitstempel (Unix-Timestamp)
[acc_atime](I) Aktivierungszeitstempel (Unix-Timestamp)
[acc_ltime](I) Zeitstempel des letzten Zugriffs (Unix-Timestamp)
[acc_rtime](I) Verbleibendes Zeitkontingent des Accounts in Sekunden
[acc_fulltime](I) Volles Zeitkontingent des Accounts in Sekunden

GatewayObjekt
[uid](S) UID des Hotspot-L4
[name](S) Name des Hotspot-L4

ConnectionObjekt
[token](S) Verwendetes Verbindungstoken
[token_status](I) Status der Verbindung: 0=Unused, 1=In use, 2=Used, 3=Pending to disconnect
[start](I) Start der Verbindung (Unix-Timestamp)
[stop](I) Ende der Verbindung (Unix-Timestamp)
[incoming](I) Eingehende Bytes der Verbindung
[outgoing](I) Ausgehende Bytes der Verbindung
[ip_user](S) Über DHCP intern zugewiesene IP des Nutzers
[ip_gateway](S) IP des Gateways(Hotspot)
[mac](S) MAC-Adresse des Benutzers
[lang](S) Gewählte Sprache des Nutzers
[last_updated](I) Letzte Verbindungsaktualisierung (Unix-Timestamp)

Fehlercodes(faultcode:faultstring):
01:No such account
02:No such gateway
03:No such type
04:No such time
05:No such action
06:No such period

Beispiel(PHP-5.1) mit Fehlerbehandlung:
try { $account = $client->createAccount("U99999999:timewindow:1d"); echo $account->code; } catch (SoapFault $soapFault) { echo $soapFault->faultcode.":".$soapFault->faultstring; }

Systemvoraussetzung: HTTPS-fähige SOAP-Softwareschnittstelle

Sicherheit: Die Datenübertragung mit dem Webservice wird durch eine sichere Verbindung geschützt (SSL mit 256bit Verschlüsselung).

Referenzen:
“Simple Object Access Protocol (SOAP) 1.1” (http://www.w3.org/TR/2000/NOTE-SOAP-20000508/)
“SOAP 1.2 Part 0: Primer” (http://www.w3.org/TR/2003/REC-soap12-part0-20030624/)
“SOAP 1.2 Part 1: Messaging Framework" (http://www.w3.org/TR/2003/REC-soap12-part1-20030624/)
"SOAP 1.2 Part 2: Adjuncts" (http://www.w3.org/TR/2003/REC-soap12-part2-20030624)
“Web Services Description Language (WSDL) 1.1” (http://www.w3.org/TR/2001/NOTE-wsdl-20010315)
"XML Schema Part 1: Structures" (http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/)
"XML Schema Part 2: Datatypes" (http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/)

-> Anfang

© 2004-2011 Thomas Lehner GmbH  powered by  →be-on-net.de Impressum | Datenschutz
Diese Seite bookmarken bei...
del.icio.us BlinkList Folkd Furl Google Linkarena Mister Wong oneview Yahoo MyWeb YiGG Webnews