ESETi pilvekonsoolide rakenduste programmeerimisliidesed (API)
Et mõista, kuidas muudatused teie integreerimist mõjutavad, on oluline eristada lüüsi ja rakenduse programmeerimisliidese (API) kategoori aid, mida see kasutab.
ESET Connect (värav)
ESET Connect on pilvehostitud lüüs, mida haldab täielikult ESET. See toimib sisenemispunktina järgmiste ESET-i pilveteenuste kliendi ja taustteenuste vahel:
ESET Connect API kategooriad
Värav pakub juurdepääsu konkreetsetele API-de komplektidele, mis on jaotatud kategooriatesse.
Versioonimine |
Igal API kategoorial on oma sõltumatu versiooni elutsükkel. See on versioon, mille määrate oma koodilingil (nt /v1/groups). |
Mõju |
ESET Connect API kategooriate värskendused võivad muuta API-kõnesid. |
Elutsükli lõpu poliitika |
Muudatuste poliitika rikkumine
ESET võib teha muudatusi ilma ette teatamata, kui muudatust loetakse mittekatkestavaks.
ESET teeb mõistlikke jõupingutusi, et teavitada teid muudatuste katkestamisest eelnevalt ja annab piisavalt aega nende muudatustega kohanemiseks. |
Katkine muudatus on rakenduste programmeerimisliideste (API-d) muudatus, mis võib nõuda rakenduse muudatusi, et vältida teie integreerimist häirivaid häireid, või teha vajalikke muudatusi ühilduvuse säilitamiseks.
Järgnevalt on toodud mõned näited muudatustest, mida peame muutusteks:
•muudetud vastusvormingut,
•väli ümber nimetati,
•väli eemaldatud,
•andmetüübi muutus,
•veakoodi muutus,
•Äriloogika muutus.
Katkestavate muudatuste põhjuseks võivad olla ka autentimise, loa ulatuse, kiiruse piirangute, transpordite/URL-i muudatuste ja muude teguritega seotud muudatused.
Mittem urdlik muutus on muutus, millega saate oma äranägemisel ja tempos ilma häireta kohaneda.
Järgnevalt on toodud mõned näited muudatustest, mida peame muutustest mitte rikkuvaks:
•uus väli lisatud,
•lisatud on uus valikuline parameeter,
•uus lisandväärtus,
•suurenenud määra piirmäär,
•rohkemate vormingute toetamine jne.
Üleminekuperiood
Üleminekuperioodil, kuna ajavahemik, mille jooksul API-kategooria eelmine versioon jääb kättesaadavaks pärast uue API-kategooria versiooni kasutuselevõttu või funktsionaalse asendamise kasutuselevõttu, on eelmine versioon jätkuvalt saadaval määratletud piiratud tugiperioodi jooksul. ESET teeb mõistlikke jõupingutusi ühilduvuse tagamiseks ja annab klientidele piisavalt aega nende muudatustega kohanemiseks.
ESET Connect API kategooriate versiooni piiratud tugi algab väljakuulutatud kuupäeval, tavaliselt lõppklientidele avaliku väljakuulutamise kuupäeval. ESET Connect API kategooriate versioon liigub piiratud tugiteenuse juurde ja see on saadaval kogu ajavahemiku jooksul kuni selle eluea lõpuni. Pärast piiratud toe lõppu pole ESET Connect API kategooriate versioon enam saadaval.
Versioonimise poliitika
Muudatuste purustamine |
Iga katkemuudatust sisaldav versioon on dokumentatsioonis selgelt märgitud. |
Mittepurunevad muudatused |
Kui versioon sisaldab ainult mittekatkestavaid muudatusi, jääb API kategooria versioon samaks. Üksikasjad leiate ESET Connect Online'i abidokumentatsioonist. |