#Descriere Documentatie

Acesta este un API de tip REST, cu cereri tip HTTP POST sau HTTP GET în formatul JSON și raspunsuri in format JSON sau XML

Charsetul folosit atat pentru cereri cat si pentru raspunsuri este UTF-8.

Autentificare

Toate cererile trebuie autentificate cu o cheie API.Pentru a obtine o cheie API, trebuie sa te inregistrezi.Apoi vei putea genera oricate chei API. Contul tau va trebui confirmat urmand link-ul trimis pe adresa de email inainte sa trimiți cereri catre API.

Paramtrii obligatorii request

Parametru Descriere Tip Utilizare
apiKey Cheia de autentificare STRING 32 GET si POST
cmd Comanda de executat STRING 50 GET si POST

CHEIA API si comanda se paseaza intr-un PARAMETRU HTTP (POST SAU GET) apiKey=cheie&cmd=methoda;

Paramtrii optionali request

Parametru Descriere Tip Utilizare Optiuni
tip Tipul de raspuns STRING GET si POST json sau xml
filtrare Comanda extra de executat JSON GET ORICE CAMP DIN TABELA DATA CU VALOAREA LUI
Ex : {"id":"2","tip":"UM"}
dataStart Data minima pentru interogare DATETIME 19 GET FORMAT DATE TIME
Ex : 2018-05-22 14:22:33
dataEnd Data maxima pentru interogare DATETIME 19 GET FORMAT DATE TIME
Ex : 2018-05-30 18:00:00

Formate parametrii

Datele si timpii sunt specificate în formatul ISO8601,fara fus orar

Tip Descriere Exemplu
INT VALORI NUMERICE 1234
DECIMAL VALORI CU CARACTER DECIMAL . 1234.99
DATE DFORMAT DATE 2018-05-22
BASE64 DATE CODATE IN FORMATUL BASE64
( IMAGINE sau PDF )
REFURSBDT0RBVEUoIElNQUdJTkUgc2F1IFBERiAp
JSON DATE IN FORMAT JSON [{"id":"1","tip":"UM"},{"id":"2","tip":"UM"}]
TEXT STRING DE CARACTERE CARACTERE ACCEPTATE : a-z A-Z 0-9-&_@*%()/\#,|!.?

Exemplu executie PHP

function connect($x){
	$curl = curl_init();
	curl_setopt($curl, CURLOPT_URL, "https://demo.edls.ro/api/index.php");
	curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($curl, CURLOPT_HEADER, false);
	curl_setopt($curl, CURLOPT_FAILONERROR, true);
	curl_setopt($curl, CURLOPT_POST, true);
	curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 0);
	curl_setopt($curl, CURLOPT_TIMEOUT, 30);
	curl_setopt($curl, CURLOPT_POSTFIELDS, $x);
	curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
	$raspuns = curl_exec ($curl);
	$httpcode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
	if(curl_error($curl)){$raspuns = "Curl error: " . curl_error($curl);}
	if($httpcode != 200){$raspuns = $httpcode;}
	curl_close ($curl); 
	return $raspuns;
}
$x = array("apiKey"=>"123465789","cmd"=>"GetArticol","tip"=>"json");
$x["dataStart"] = "2017-01-01 00:00:00";
$x["dataEnd"] = "2017-06-30 23:59:59";
$x["filtrare"] = json_encode(array("scos_vanare"=>"0","iddep"=>"1"));
$data = connect(http_build_query($x, null, "&"));