Money: Porovnání verzí

Z HKfree wiki
Skočit na navigaci Skočit na vyhledávání
 
m
 
(Není zobrazeno 17 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 '''igw1.hkfree.org''', který je fyzicky umístěn v centralni serverovne na PMV<br />
+
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 34: Řádek 35:
  
 
všechny výstupy jsou vraceny v poli.
 
všechny výstupy jsou vraceny v poli.
 +
 +
----
 +
Funkce ktere se jsou jiz v provozu:
 +
  
 
'''1) Výpis stavu uživatele''' <br />
 
'''1) Výpis stavu uživatele''' <br />
 
funkce:'''hkfree_money_userIsActive(); '''<br />
 
funkce:'''hkfree_money_userIsActive(); '''<br />
 
vstup - int [id] <br />
 
vstup - int [id] <br />
výstup - bool,bool,string [result, stav, text] <br />
+
* '''id''' ID uzivatele o kterem chceme pozadovane info
* '''result''' vrací true ci false zda se funkce zdarila ci nezdarila
+
výstup - bool,bool,string [result, isActive, text] <br />
* '''stav''' stav uzivatele v systemu
+
* '''result''' vrací true ci false zda se funkce zdarila ci nezdarila (1|0)
* '''text''' pripadna error hlaska
+
* '''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''' <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:
 +
 
 +
'''4) Odstranit/nastavit disablovani usera''' <br />
 +
funkce:'''hkfree_money_userSetDisabled(); '''<br />
 +
vstup - int [id] <br />
 +
* '''id''' ID uzivatele kteremu chceme nastavit/zrusit stav Disabled
 +
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
 +
 
 +
'''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 ===
<bash>
+
<source lang="perl">
 
#!/usr/bin/perl
 
#!/usr/bin/perl
 
#  
 
#  
Řádek 60: Řádek 114:
 
#Init soap object
 
#Init soap object
 
my $soap = SOAP::Lite
 
my $soap = SOAP::Lite
   -> service('https://$id:$heslo\@money.hkfree.org/wsdl/moneyAPI.wsdl');
+
   -> 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 '$id' => '$heslo';
+
     return "$id" => "$heslo";
 
}
 
}
  
Řádek 74: Řádek 128:
 
print Dumper \@res;
 
print Dumper \@res;
  
</bash>
+
</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

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";

?>