Money: Porovnání verzí
m |
|||
(Není zobrazeno 13 mezilehlých verzí od 4 dalších uživatelů.) | |||
Řádek 5: | Řádek 5: | ||
Slouží k '''informacim o virtuálních účtech''' uživatelů HKfree a správcovský přístup pro aktivaci/deaktivaci jednotlivých uživatelských účtů.<br /> | Slouží k '''informacim o virtuálních účtech''' uživatelů HKfree a správcovský přístup pro aktivaci/deaktivaci jednotlivých uživatelských účtů.<br /> | ||
<br /> | <br /> | ||
− | Běží na stroji ''' | + | Běží na stroji '''igw3.hkfree.org''', který je fyzicky umístěn v centralni serverovne na PMV<br /> |
Přístup do ní mají všichni nesmazaní uživatelé<br /> | Přístup do ní mají všichni nesmazaní uživatelé<br /> | ||
Technickým správcem databáze je '''kendy''' (Jabber ID: kendy@jabber.hkfree.org).<br /> | Technickým správcem databáze je '''kendy''' (Jabber ID: kendy@jabber.hkfree.org).<br /> | ||
+ | Nove pozadavky zadavejte na https://jira.hkfree.org/browse/MNY (komponenta Money) | ||
Je v provozu ode dne oficiálního založení sdružení, tj. od 10.4.2004.<br /> | Je v provozu ode dne oficiálního založení sdružení, tj. od 10.4.2004.<br /> | ||
Řádek 44: | Řádek 45: | ||
* '''id''' ID uzivatele o kterem chceme pozadovane info | * '''id''' ID uzivatele o kterem chceme pozadovane info | ||
výstup - bool,bool,string [result, isActive, text] <br /> | výstup - bool,bool,string [result, isActive, text] <br /> | ||
− | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila | + | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila (1|0) |
* '''isActive''' stav uzivatele v systemu | * '''isActive''' stav uzivatele v systemu | ||
− | * '''text''' pripadna error hlaska | + | * '''errormessage''' pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK) |
+ | |||
+ | '''2) Výpis zda je uzivatel nastaven k automatické deaktivaci''' <br /> | ||
+ | funkce:'''hkfree_money_userIsDisabled(); '''<br /> | ||
+ | vstup - int [id] <br /> | ||
+ | * '''id''' ID uzivatele o kterem chceme pozadovane info | ||
+ | výstup - bool,bool,string [result, isDisabled, text] <br /> | ||
+ | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila (1|0) | ||
+ | * '''isDisabled''' stav uzivatele zda je ci neni nastaven k automaticke deaktivaci | ||
+ | * '''errormessage''' pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK) | ||
+ | |||
+ | '''3) Stav uzivatelova virtualniho uctu v Kc''' <br /> | ||
+ | funkce:'''hkfree_money_userGetAccountBalance(); '''<br /> | ||
+ | vstup - int [id] <br /> | ||
+ | * '''id''' ID uzivatele o kterem chceme pozadovane info | ||
+ | výstup - bool,int,string [result, balance, text] <br /> | ||
+ | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila (1|0) | ||
+ | * '''balance''' stav uzivatelova virtualniho uctu v Kc | ||
+ | * '''errormessage''' pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK) | ||
---- | ---- | ||
Funkce ktere se budou vyvijet: | Funkce ktere se budou vyvijet: | ||
− | + | '''4) Odstranit/nastavit disablovani usera''' <br /> | |
− | ''' | + | funkce:'''hkfree_money_userSetDisabled(); '''<br /> |
− | funkce:''' | ||
vstup - int [id] <br /> | vstup - int [id] <br /> | ||
− | * '''id''' ID uzivatele | + | * '''id''' ID uzivatele kteremu chceme nastavit/zrusit stav Disabled |
výstup - bool,bool,string [result, isDisabled, text] <br /> | výstup - bool,bool,string [result, isDisabled, text] <br /> | ||
− | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila | + | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila (1|0) |
* '''isDisabled''' stav uzivatele zda je ci neni nastaven k automaticke deaktivaci | * '''isDisabled''' stav uzivatele zda je ci neni nastaven k automaticke deaktivaci | ||
− | * '''text''' pripadna error hlaska | + | * '''errormessage''' pripadna error hlaska |
+ | |||
+ | '''5) Aktivace usera''' <br /> | ||
+ | funkce:'''hkfree_money_userSetActivate(); '''<br /> | ||
+ | vstup - int [id] <br /> | ||
+ | * '''id''' ID uzivatele kteremu chceme nastavit/zrusit stav Disabled | ||
+ | výstup - bool,bool,int,string [result, isActivated, zustatek, text] <br /> | ||
+ | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila (1|0) | ||
+ | * '''isActivated''' stav uzivatele zda je ci neni nastaven k automaticke deaktivaci | ||
+ | * '''zustatek''' aktualni zustatek penez v Kc (po provedene aktivaci) - vypise se pouze pokud byla provedena uspesna aktivace i s odectem penez | ||
+ | * '''errormessage''' pripadna error hlaska | ||
+ | |||
+ | '''6) Seznam aktivnich/neaktivnich ID do netu''' <br /> | ||
+ | funkce:'''hkfree_money_userGetStateIDs(); '''<br /> | ||
+ | vstup - int [id] <br /> | ||
+ | * '''type''' 1 - pro ziskani vsech aktivnich ID; 0 - pro ziskani vsech neaktivnich ID | ||
+ | výstup - bool,string,string [result, idList, text] <br /> | ||
+ | * '''result''' vrací true ci false zda se funkce zdarila ci nezdarila (1|0) | ||
+ | * '''idList''' seznam IDcek oddelenych strednikem (1;3;4;5...) | ||
+ | * '''errormessage''' pripadna error hlaska | ||
=== Příklad přístupu z perlu === | === Příklad přístupu z perlu === | ||
− | < | + | <source lang="perl"> |
#!/usr/bin/perl | #!/usr/bin/perl | ||
# | # | ||
Řádek 77: | Řádek 114: | ||
#Init soap object | #Init soap object | ||
my $soap = SOAP::Lite | my $soap = SOAP::Lite | ||
− | -> service( | + | -> service("https://$id:$heslo\@money.hkfree.org/wsdl/moneyAPI.wsdl"); |
#Set my credentials to the soap object | #Set my credentials to the soap object | ||
sub SOAP::Transport::HTTP::Client::get_basic_credentials { | sub SOAP::Transport::HTTP::Client::get_basic_credentials { | ||
− | return | + | return "$id" => "$heslo"; |
} | } | ||
Řádek 91: | Řádek 128: | ||
print Dumper \@res; | print Dumper \@res; | ||
− | </ | + | </source> |
+ | |||
+ | === Příklad přístupu z PHP === | ||
+ | <source lang="php"> | ||
+ | <?php | ||
+ | |||
+ | $id = 'mojeID'; | ||
+ | $heslo = 'mojeTajneHeslo'; | ||
+ | |||
+ | $client = new SoapClient( | ||
+ | 'https://' . $id . ':' . $heslo . '@money.hkfree.org/wsdl/moneyAPI.wsdl', | ||
+ | array( | ||
+ | 'login' => $id, | ||
+ | 'password' => $heslo, | ||
+ | 'trace' => 1, | ||
+ | ) | ||
+ | ); | ||
+ | |||
+ | echo "FUNCTIONS:\n"; | ||
+ | var_dump( $client->__getFunctions() ); | ||
+ | echo "TYPES:\n"; | ||
+ | var_dump( $client->__getTypes() ); | ||
+ | |||
+ | $id=144; | ||
+ | |||
+ | var_dump( $client->hkfree_money_userIsActive($id) ); | ||
+ | var_dump( $client->hkfree_money_userIsDisabled($id) ); | ||
+ | var_dump( $client->hkfree_money_userGetAccountBalance($id) ); | ||
+ | |||
+ | echo "END:\n"; | ||
+ | |||
+ | ?> | ||
+ | </source> |
Aktuální verze z 8. 2. 2010, 13:39
Obsah
Platebni systém o.s. HKfree
Je známá též pod krycím názvem money
Slouží k informacim o virtuálních účtech uživatelů HKfree a správcovský přístup pro aktivaci/deaktivaci jednotlivých uživatelských účtů.
Běží na stroji igw3.hkfree.org, který je fyzicky umístěn v centralni serverovne na PMV
Přístup do ní mají všichni nesmazaní uživatelé
Technickým správcem databáze je kendy (Jabber ID: kendy@jabber.hkfree.org).
Nove pozadavky zadavejte na https://jira.hkfree.org/browse/MNY (komponenta Money)
Je v provozu ode dne oficiálního založení sdružení, tj. od 10.4.2004.
WWW přístup
Na adrese http https://money.hkfree.org/
login: ID z tvojí přihlášky
heslo: heslo z tvojí přihlášky (bacha na malá/velká písmena)
SOAP přístup (vývoj 12/2008-xxx)
Přístup mají výhradně jen správci
Technologie
Linux, Perl 5.8.8, modul SOAP::Lite, FastCGI, Apache 2.2.x, MySQL 5.0.x
WSDL
https://money.hkfree.org/wsdl/moneyAPI.wsdl
pro přístup k wsdl souboru pouzijte vase ID a heslo
specifikace API
API obsahuje či by mělo obsahovat tyto možnosti (metody):
všechny výstupy jsou vraceny v poli.
Funkce ktere se jsou jiz v provozu:
1) Výpis stavu uživatele
funkce:hkfree_money_userIsActive();
vstup - int [id]
- id ID uzivatele o kterem chceme pozadovane info
výstup - bool,bool,string [result, isActive, text]
- result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
- isActive stav uzivatele v systemu
- errormessage pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK)
2) Výpis zda je uzivatel nastaven k automatické deaktivaci
funkce:hkfree_money_userIsDisabled();
vstup - int [id]
- id ID uzivatele o kterem chceme pozadovane info
výstup - bool,bool,string [result, isDisabled, text]
- result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
- isDisabled stav uzivatele zda je ci neni nastaven k automaticke deaktivaci
- errormessage pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK)
3) Stav uzivatelova virtualniho uctu v Kc
funkce:hkfree_money_userGetAccountBalance();
vstup - int [id]
- id ID uzivatele o kterem chceme pozadovane info
výstup - bool,int,string [result, balance, text]
- result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
- balance stav uzivatelova virtualniho uctu v Kc
- errormessage pripadna error hlaska (pri probehnuti vseho v poradku je zde text OK)
Funkce ktere se budou vyvijet:
4) Odstranit/nastavit disablovani usera
funkce:hkfree_money_userSetDisabled();
vstup - int [id]
- id ID uzivatele kteremu chceme nastavit/zrusit stav Disabled
výstup - bool,bool,string [result, isDisabled, text]
- result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
- isDisabled stav uzivatele zda je ci neni nastaven k automaticke deaktivaci
- errormessage pripadna error hlaska
5) Aktivace usera
funkce:hkfree_money_userSetActivate();
vstup - int [id]
- id ID uzivatele kteremu chceme nastavit/zrusit stav Disabled
výstup - bool,bool,int,string [result, isActivated, zustatek, text]
- result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
- isActivated stav uzivatele zda je ci neni nastaven k automaticke deaktivaci
- zustatek aktualni zustatek penez v Kc (po provedene aktivaci) - vypise se pouze pokud byla provedena uspesna aktivace i s odectem penez
- errormessage pripadna error hlaska
6) Seznam aktivnich/neaktivnich ID do netu
funkce:hkfree_money_userGetStateIDs();
vstup - int [id]
- type 1 - pro ziskani vsech aktivnich ID; 0 - pro ziskani vsech neaktivnich ID
výstup - bool,string,string [result, idList, text]
- result vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
- idList seznam IDcek oddelenych strednikem (1;3;4;5...)
- errormessage pripadna error hlaska
Příklad přístupu z perlu
#!/usr/bin/perl
#
#
use Data::Dumper;
use SOAP::Lite;
use SOAP::WSDL;
#My credentials
my $id = 1234; #Moje ID
my $heslo = 'mojetajneheslo'; #Moje heslo (pokud jsem si heslo zmenil v money, tak pouziji to)
#Init soap object
my $soap = SOAP::Lite
-> service("https://$id:$heslo\@money.hkfree.org/wsdl/moneyAPI.wsdl");
#Set my credentials to the soap object
sub SOAP::Transport::HTTP::Client::get_basic_credentials {
return "$id" => "$heslo";
}
my $info_about_this_id = 1234;
#call function with one parameter
@res = $soap->hkfree_money_userIsActive($info_about_this_id);
#Display Result
print Dumper \@res;
Příklad přístupu z PHP
<?php
$id = 'mojeID';
$heslo = 'mojeTajneHeslo';
$client = new SoapClient(
'https://' . $id . ':' . $heslo . '@money.hkfree.org/wsdl/moneyAPI.wsdl',
array(
'login' => $id,
'password' => $heslo,
'trace' => 1,
)
);
echo "FUNCTIONS:\n";
var_dump( $client->__getFunctions() );
echo "TYPES:\n";
var_dump( $client->__getTypes() );
$id=144;
var_dump( $client->hkfree_money_userIsActive($id) );
var_dump( $client->hkfree_money_userIsDisabled($id) );
var_dump( $client->hkfree_money_userGetAccountBalance($id) );
echo "END:\n";
?>