Uuendatud 04. august 2026

SEADISTUSED REST API FUNKTSIONAALSUSE KASUTAMISEKS

API kasutamise eeldused

1. Excellent Books või Excellent ERP pakett, versioon 8.5 või uuem.

2. Excellent Books paketis on moodul “API” ja “Veebipood & CMS“.
Excellent ERP paketis moodul “Veebipood“.

3. Seadistused Booksi tarkvaras:
Kõik järgnevad seadistused on andmebaasipõhised, st piisab kui teha ainult ühes ettevõttes (v.a. punktid 3.3. ja 3.4)

3.1. Moodul “Veebipood ja CMS” > Seadistused > “Ligipääs funktsioonidele veebist” (ingl.k. “Access to functions from web”).
Siin seadistuses määratakse, millistele API funktsioonidele on välisest veebist ligipääs lubatud. See on vajalik näiteks liidestuste (nagu e-poed, pangaliidesed või muud välised süsteemid) toimimiseks. Täida käsitsi rida:

• Funktsioon: API
• Avalik: määrab, kas funktsioon on avalik või nõuab sisselogitud kasutajat. Soovitame valida “Sisseloginud kasutaja“.
• SSL: kas kasutatakse krüpteeritud ühendust. Soovitame valida “jah“, kui kasutusel on HTTPS. HTTP puhul vali “ei”.
• Sessioon: kas kasutatakse sessiooni. Server-to-server lahenduste puhul soovitame valida “Ei“.
• Lubatud IP-d: võimaldab piirata ligipääsu ainult konkreetsetele IP-aadressidele turvalisuse suurendamiseks. Täida see ainult juhul, kui soovid lubada vaid kindla IP aadressi pealt päringuid. Mitu IP aadressi tuleb eralda komaga, näiteks:
  90.191.43.252,213.35.184.82
• IP aadressite vahemik on võimalik määrata järgnevalt:
  10.0.55.100–10.0.55.200
  või
  192.168.0.0/16

3.2. Moodul Üldine > Seadistused > “Valikulised võimalused”. Märgi valikud:

• “Veebi Rest API“
• “Luba HTTP autentimine“
• “Ekspordi järjekorra numbrid (sünkroniseerimine)“
• “Uuendavad veebipäringud aruannete võtmise ajal” (vahelehel „Mittesoovitatud“)

3.3. Päringutes tuleb kasutada valideeritud kasutajaga (isik) seotud emaili ja parooli. Sisse logimiseks peab kasutama valideeritud e-maili ja sellega seotud parooli. Uue isiku loomise ja valideerimise juhendi leiad SIIT.

Seadistus tuleb täita igas ettevõttes, millest andmeid soovitakse pärida.

3.4. Moodul Üldine > Seadistused > “Kasutajagrupid”.
Isik, kelle nimega päringuid teostatakse, peab olema seotud kasutajagrupiga, millele on lisatud eraldi reaga õigus:
Toiming /  Rest API / Täis

Samuti tuleb kasutajagrupil loetleda moodulid ja registrid, millele kasutajal on lubatud ligipääs. Registrid, mille infot soovitakse Excellent Booksist API-ga ainult vaadata (GET päringud), võib kasutada Tase = Vaata. Kui API kasutatakse andmete kirjutamiseks (PATCH või POST päringud).

Seadistus tuleb täita igas ettevõttes, millest andmeid soovitakse pärida.

3.7. Päringute kirjutamiseks vajalike Excellent Booksi registrite ja tabelite formaatide kirjeldused leiad SIIT

Põhjaliku Excellent Books API seadistamise dokumentatsiooni leiad SIIT (ingl. k.)

Lisainfo:

• Excellenti pilveteenuse kasutajale seadistatakse sertifikaadid ja pordid Excellenti administraatori poolt.
• API juurutamisel soovitame alati eelnevalt test andmebaasi.
• API huvi korral võtke ühendust meie projektijuhiga myyk@excellent.ee, et kokku leppida kasutuselevõtu tingimused.

(powerbi, microsoft power bi, ärianalüüsi, SOAP, sertifikaat, wordpress, woocommerce, epood, veebipood, koduleht, api seadistamine, api seadistused, andmevahetus, shopify, ligipääs funktsioonidele)