Tekst źródłowy

== Informacje ==
Komunikacja odbywa się po sockecie szyfrowanym SSLv3
Domyślny port serwera Net47 to 2047
Jest to jedyna możliwość komunikacji z Net47

== Przykładowe uzyskanie połączenia ==
<pre>openssl s_client -connect 127.0.0.1:2047 -ssl3</pre>

== Struktura komunikacji ==
Struktura komunikacji opiera się o XML.
*Początek transakcji oznaczamy<pre>//BEGIN//\n</pre>(\n jest znacznikiem klawisza [enter]) po rozpoczęciu sekcji BEGIN, podajemy zapytanie sformułowane w XML
*Header:<pre><?xml version="1.0" encoding="UTF-8"?></pre>
*Pierwsza sekcja w której zawarte będą wszystkie zadania (koniecznie nazwa Net47):<pre><Net47></pre>Zaczynamy właściwą transakcję (przykład logowania):
**Podajemy SessionID (oczywiście przed zalogowaniem go nie posiadamy) [ char[32] ]<pre>	<SessionID></SessionID></pre>
**Sekcja Request, w niej zawierają się wszystkie zlecane zadania<pre>	<Request></pre>
***Zawartość Type definiuje iż będziemy spodziewać się sekcji o tej samej nazwie co zawartość (powtarzalne wielokrotnie), co odpowiada także typowi akcji:<pre>		<Type>Authorization</Type></pre>
***Zlecenie o nazwie wcześniej zdefiniowanego Type, jeśli pojawi się sekcja nie określona w Type, zostanie ona pominięta:<pre>		<Authorization></pre>
****Wartości wymagane dla autoryzacji:<pre>			<UserName>testowy</UserName></pre><pre>			<Password>testowy</Password></pre>
***Zamknięcie sekcji<pre>		</Authorization></pre>
**Zamknięcie sekcji<pre>	</Request></pre>
*Zamknięcie XML<pre></Net47></pre>
*Jest jeszcze warunek ukończenia transakcji<pre>//BEGINEND//\n</pre> (\n jest znacznikiem klawisza [enter])
W tym momencie transakcja zostaje przetworzona, otrzymujemy [zwrotkę]#Zwrotka informującą nas o id kolejki zlecenia, lub w przypadku logowania otrzymamy od razu ID sesji

== Zwrotka ==
Początek transakcji zwrotki jest oznaczony<pre>//BEGIN//\n</pre>
*Header:<pre><?xml version="1.0" encoding="UTF-8"?></pre>
*Pierwsza sekcja w której zawarte będą wszystkie zadania:<pre><Net47></pre>
**Request otwierający sekcje gdzie zawarte będą odpowiedzi:<pre><Request></pre>
***Type realizuje tą samą funkcję jak przy zapytaniu:<pre><Type>Authorization</Type></pre>
***Właściwa odpowiedź:<pre><Authorization><SessionID>32a1e3c5b537d00e39ef15db9c0b6839</SessionID></Authorization></pre>
**Zamknięcie sekcji:<pre></Request></pre>
*Zamknięcie sekcji:<pre></Net47></pre>
Zakończenie transakcji:<pre>//BEGINEND//\n</pre>

== Przykład zapytania wraz z odpowiedzią ==
<pre>
//BEGIN//
<?xml version="1.0" encoding="UTF-8"?>
<Net47>
	<SessionID>32a1e3c5b537d00e39ef15db9c0b6839</SessionID>
	<Priority>3</Priority>
	<Term>Short</Term>
	<Request>
		<Type>AuthorizationLogout</Type>
		<AuthorizationLogout>
			<SessionID>32a1e3c5b537d00e39ef15db9c0b6839</SessionID>
		</AuthorizationLogout>
	</Request>
</Net47>
//BEGINEND//


//BEGIN//
<?xml version="1.0" encoding="UTF-8"?>
<Net47>
	<Request>
		<Type>QueueID</Type>
		<QueueID>
			<ID>5</ID>
		</QueueID>
	</Request>
</Net47>
//BEGINEND//
</pre>

[[Kategoria:ProcedurySQL]]