Minimax API
Minimax API je RESTful web servis koji vam omogućava da se povežete sa spoljnim aplikacijama za različite potrebe korišćenja. Omogućava vam da koristite određene funkcije koje su ugrađene u minimax. Tehnička dokumentacija za Minimax API je dostupna na sledećem LINKU
Koristeći API slažete se sa uslovima korišćenja Minimax API uslovi korišćenja
Eksterni programeri
Ako sami razvijate povezivanje preko API, po uspešnoj saradnji u Minimax obratite se podršci(preko zahteva za pomoć ili na podrska@seyfor.rs) da biste dobili podatke klijenta/kupca za povezivanje.
Podaci za prijavu
Prijavite se u Minimax i u delu moj profil kliknete na uredi osnovne podatke da bi vam se otvorio Saop nalog. U donjem delu kliknete na dugme Nova aplikacija. Unesete u prozoru naziv aplikacije, korisničko ime i lozinku sa kojom bi se kao korisnik prijavljivali na API.
Uređivanje podešavanja u programu
Na podešavanju pakete mora biti čekiran API a na podešavanju korisnika treba da korisnik ima prava API na nekoj od organizacija sa kojom se povezuje.
Primer
Korisnički primer:
- PHP - MinimaxAPISamplePHP
- C# - MinimaxAPISample
- Za authentication se koristi protokol OAuth2 (članakk OAuth 2 Simplified).
- Najpre se prijavite u AUT sa podacima klijenta/kupca(ID-em klijenta) i sa korisničkim imenom i šifrom koje ste uneli na Saop-ovom nalogu (gledaj Autentikacija korisnika), da dobijete token. Dobijeni token koristite pri svakom pozivu API metode.
- Primer u PHPju
<?php$params = array(
'client_id'=> 'ClientId',
'client_secret'=> 'ClientPassword',
'grant_type'=> 'password',
'username'=> 'UserName',
'password'=> 'UserPassword',
'scope' => 'minimax.rs');
$request = array(
'http' => array(
'method'=> 'POST',
'header'=> array(
'Content-type: application/x-www-form-urlencoded',
),
'content'=> http_build_query($params),
'timeout'=> 10
)
);
if (!$response = file_get_contents('https://moj.minimax.rs/RS/aut/oauth20/token', false, stream_context_create($request))) {
die('auth error');
}
$token = json_decode($response); $request = array(
'http' => array(
'method'=> 'GET',
'header'=> 'Authorization: Bearer ' . $token->access_token,
'timeout'=> 10
)
); if (!$response = file_get_contents('https://moj.minimax.rs/RS/api/api/currentuser/orgs', false, stream_context_create($request))) {
die('orgs error');
}
$orgs = json_decode($response, true); print_r($orgs);?>
Upotreba podataka RowVersion
Prilikom ažuriranja zapisa i pri nekim akcijama, javljaju se podaci RowVersion, koji služe ažuriranju najnovije verzije zapisa. Podaci se dobijaju čitanjem objekta preko pripadajuće GET metode za čitanje pojedinog zapisa.
U primeru, da se zapis u međuvremenu promenio, interfejs vraća povezanu grešku:
Concurrency error - record changed by another action (RowVersion)