Open data

API-uri Publice regionordest.ro:

Pentru a obține toate proiectele:

URL: https://regionordest.ro/wp-json/wp/v2/proiect

Filtrare proiecte în funcție de SMIS:

URL: https://regionordest.ro/wp-json/wp/v2/proiect?SMIS=147997

Filtrare proiecte în funcție de localitate:

URL: https://regionordest.ro/wp-json/wp/v2/proiect?localitate=AGAPIA

Filtrare proiecte în funcție de județ:

URL: https://regionordest.ro/wp-json/wp/v2/proiect?judet=NEAMT

Prezentare generală:

Website-ul www.regionordest.ro dispune de un API REST personalizat care vă permite să preluați și să manipulați date folosind cereri HTTP. Acest API respectă principiile RESTful și poate fi utilizat pentru a integra site-ul dvs. cu alte aplicații sau servicii. Acest API este organizat în jurul arhitecturii REST. API-ul nostru are URL-uri orientate către resurse, returnează răspunsuri codificate în format JSON și utilizează coduri standard HTTP.

Endpoint API Rest: https://regionordest.ro/wp-json/wp/v2/proiect

Pentru a pune toate acestea împreună, URL-ul https://regionordest.ro/wp-json/wp/v2/proiect  este utilizat pentru a accesa o resursă specifică sau date legate de „proiect”, folosind versiunea 2 a API-ului WordPress REST. Acesta poate fi folosit pentru a prelua doar date legate de această resursă folosind cereri HTTP.

Prezentarea componentelor URL-ului:

https://regionordest.ro: Aceasta este adresa URL de bază a website-ului.

/wp-json: Aceasta este partea URL-ului care indică utilizarea API-ului WordPress REST. Este un prefix comun utilizat pentru a accesa endpoint-urile API-ului REST în WordPress.

/wp/v2: Aceasta este versiunea API-ului WordPress REST care este utilizată. În cazul nostru, este versiunea 2 a API-ului.

/proiect: Aceasta este endpoint-ul specific care este accesat. Un endpoint este un URL care reprezintă o resursă sau acțiune specifică în cadrul API-ului. În cazul nostru, se referă la „proiect,” care este un tip de conținut personalizat pe website.

Endpoint-uri:

API-ul furnizează diferite endpoint-uri pentru diferite tipuri de date. Mai jos sunt câteva exemple de endpoint-uri pe care le puteți utiliza:

Preia toate proiectele:

GET /proiect

Preia un proiect după SMIS:

URL-ul endpoint-ului pentru API-ul SMIS este GET /proiect?SMIS={enter any SMIS}

Preia un proiect după localitate:

URL-ul endpoint-ului pentru API-ul localității este GET /proiect?localitate={enter any localitate}

Preia un proiect după județ:

URL-ul endpoint-ului pentru API-ul județului este GET /proiect?judet={enter any judet}

Exemple de utilizare:

Preia toate proiectele:

https://regionordest.ro/wp-json/wp/v2/proiect

CERERE

RĂSPUNS

Preia un proiect după SMIS:

URL-ul endpoint-ului pentru API-ul SMIS este https://regionordest.ro/wp-json/wp/v2/proiect?SMIS=147997
Acest API găsește și returnează proiectul care are SMIS-ul dat. Dacă SMIS-ul dat nu este găsit, atunci se afișează un mesaj de eroare.

CERERE

RĂSPUNS

Preia un proiect după localitate:

URL-ul endpoint-ului pentru API-ul localității este https://regionordest.ro/wp-json/wp/v2/proiect?localitate=BACAU
Acest API găsește și returnează toate proiectele care au localitatea dată.

CERERE

RĂSPUNS

Preia un proiect după județ:

URL-ul endpoint-ului pentru API-ul județului este https://regionordest.ro/wp-json/wp/v2/proiect?judet=NEAMT
Acest API găsește și returnează toate proiectele care au județul dat.

CERERE

RĂSPUNS

 

Erori:

Se utilizează codurile de răspuns HTTP convenționale pentru a indica succesul sau eșecul unei cereri API. În general: Codurile din gama 2xx indică succesul. Codurile din gama 4xx indică o eroare care a eșuat datorită informațiilor furnizate (de exemplu, ceva greșit în URL sau în parametru). Codurile din gama 5xx indică o eroare la nivel de server (acestea sunt rare).

Gestionarea erorilor:

Erorile sunt comunicate prin coduri de stare HTTP adecvate și mesaje de eroare în corpul răspunsului.

Limitarea ratei de cereri:

Am stabilit un număr maxim de cereri permise într-o fereastră de timp specifică: 10 req/minut. Dacă limita este depășită, clientul primește un cod de stare “429 Too Many Requests”. Limita cererilor se bazează pe adresa IP a clientului. Aceasta este utilă pentru a preveni efectuarea unui număr prea mare de cereri de către o singură adresă IP, într-un interval de timp dat.

Luați în considerare implementarea mecanismelor de limitare a ratei de cereri pentru a preveni abuzul asupra API-ului.

Pentru mai multe informații sau dacă întâmpinați probleme, contactați administratorul website-ului.