#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, "&"));