API-ul eRepublik

From eRepublik Official Wiki
< API summary
Revision as of 10:27, 19 January 2021 by Stephan Condurachis (Talk | contribs) (Created page with "{{LangMenu}} {{DISPLAYTITLE:API-ul eRepublik}} <div style="float:left;text-align:center;"> <div style="border: 2px solid #c6e4f2; background: #f1faff; -moz-border-radius: 5px;...")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Languages: 
EnglishIcon-English.png
RomânăIcon-Romania.png


Speech balloon.png Menu

Erepublik api.png

API-ul eRepublik (Interfața de programare a aplicației) este o interfață pe care jucătorii o pot folosi pentru a crea diverse programe și instrumente folosind informații din joc sau pentru a efectua acțiuni limitate în joc. EAPI furnizează date în formate compatibile cu aplicațiile precum XML și JSON și oferă, de asemenea, funcții pentru interacțiunea cu ecosistemul jocului.

Istoric

EAPI există din ianuarie 2009 și a fost modificat și extins mult de atunci. Îmbunătățirea sa continuă a fost suspendată la mijlocul anului 2009. În 2010, eAPI a fost complet actualizat pentru a reflecta schimbările unei actualizări majore a economiei eRepublik. EAPI a devenit o parte importantă a eRepublik și este utilizat într-un număr tot mai mare de aplicații extraordinare, dezvoltate de comunitatea activă eRepublik.

Versiunea 0.6 - 15.05.2010 Documentația noului eAPI care reflectă toate modificările eRepublik V2.

Versiunea 0.5 - 22.01.2009 Ultima documentație despre fosta eAPI care a fost utilizată până la lansarea eRepublik V2.

Utilizează

EAPI este un set agnostic de limbă și platformă de servicii http care poate fi utilizat pentru a construi aplicații terțe în jurul eRepublik. Actualul eAPI poate fi separat în 2 mari categorii:

Puteți prelua informații despre cetățeni, companii, războaie și entități similare pe eRepublik. Datele vor fi returnate în format XML sau JSON. Aceste funcții sunt disponibile publicului și pot fi utilizate fără nicio autorizație sau înregistrare.

  • Autentificarea utilizatorului : OAuth

Utilizatorii eRepublik se pot autentifica în aplicația dvs. utilizând acreditările lor de cont cetățean eRepublik fără a fi nevoie să predea aceste acreditări. Prin urmare, puteți crea aplicații sigure care necesită utilizatorilor să le autentifice ca cetățeni eRepublik.

Nu mai există interzicere pentru depășirea limitei și modul în care limita de cerere funcționează acum este că puteți face maximum 20 de cereri în 4 secunde (18000 de cereri pe oră dacă respectați limita). Dacă faceți 21 de cereri în mai puțin de 4 secunde, ultima solicitare va expira - foarte ușor de gestionat în orice limbă de masă. Dar după ce au trecut cele 4 secunde, puteți face 20 Mai Mult.

Feedurile sunt stocate în cache în urma acestei liste:

  • la fiecare 10 minute: cetățean după id, companii, oferte de piață, bătălii, combatanți
  • la fiecare 2 ore: regiuni, războaie
  • la fiecare 6 ore: cetățeni pe regiuni
  • la fiecare 20 de ore: țări, industrii

OAuth

Pentru funcțiile în care securitatea joacă un rol important, cum ar fi procesul de autentificare a utilizatorului, eAPI utilizează un mecanism numit OAuth în versiunea 1.0a. OAuth este un standard renumit pentru autentificarea sigură, care este utilizat de multe site-uri de pe Internet. Dacă sunteți familiarizat cu OpenID, știți deja cum să utilizați OAuth.

Puteți găsi mai multe informații și exemple despre cum să utilizați OAuth aici: OAuth. Există module și biblioteci gata de utilizat pentru OAuth pentru majoritatea limbajelor de programare, așa că, în loc să vă spunem cum să implementați OAuth singur, am dori să vă îndreptăm spre http://oauth.net/code/ pentru un lista acestor module și vă încurajează să le utilizați. Pentru mai multe informații (sau “toate”) despre OAuth, accesați pagina web oficială la http://oauth.net/.

Obținerea ajutorului

Dacă aveți probleme sau întrebări cu privire la eAPI, iată câteva locuri în care puteți găsi ajutor: