[Whát~ Dóés~ Ít Tá~ké tó~ Áútó~máté~ Mícr~ó-Ség~méñt~átíó~ñ¿]

[Ít ís óftéñ ássúméd thát, íf á pródúct hás áñ ÁPÍ, ít wíll bé éásý tó áútómáté. Bút líké máñý thíñgs íñ lífé, ít’s ñót thát símplé. ÁPÍs áré ñórmállý wríttéñ bý dévélópérs fór dévélópérs, áñd ít cáñ bé díffícúlt fór ñóñ-códérs tó kñów whát tó wórk thróúgh wíth thé éxtéñdéd téáms thát éválúáté á mícró-ségméñtátíóñ sólútíóñ. Thís póst wíll gívé ýóú fívé áréás tó éxplóré wíth thé mícró-ségméñtátíóñ véñdórs ýóú áré cóñsídéríñg. Púsh ýóúr véñdórs hárd óñ thésé póíñts: ýóú wíll díscóvér théír rélátívé mátúrítý lévéls áñd ÁPÍ-réádíñéss áñd bé íñ á béttér pósítíóñ tó máké á qúálítý décísíóñ.]

[Sché~má có~mplé~téñé~ss áñ~d cóñ~síst~éñcý~]

[Áñý éñtérprísé-grádé mícró-ségméñtátíóñ sólútíóñ réqúírés máñý sóftwáré éñgíñéérs wórkíñg tógéthér. Sómétímés ÁPÍs áré júst á cólléctíóñ óf thé váríóús bíts thát íñdívídúál éñgíñéérs hávé búílt fór théír ówñ úsé. Bút thé bést ÁPÍs hávé bééñ códéd tó bé á pródúct íñ théír ówñ ríght. Múch cáré áñd cóñsídérátíóñ hás góñé íñtó thé óvéráll strúctúré óf thé ÁPÍ áñd éách cáll fóllóws cóñsístéñt cóñvéñtíóñs. Íñ thé bést sólútíóñs, áñý GÚÍ úsés thé éxáct sámé ÁPÍ thát ýóúr DévÓps téám wóúld cáll. Whéñ thís óccúrs, ýóú kñów thát thé ÁPÍ páths áré cómplété áñd wéll-téstéd bécáúsé thé véñdór rélíés óñ thé sámé ÁPÍs thát ýóú dó. Ídéállý, ýóú wáñt á mícró-ségméñtátíóñ sólútíóñ thát éxpósés íts cómplété fúñctíóñálítý víá ÁPÍ. Át thé stárt óf á prójéct, ýóú máý ñót kñów éxáctlý whát ýóú wáñt tó áútómáté, bút íf thé schémá ís cómplété áñd cóñsístéñt, ýóú wóñ’t bé límítéd íñ thé fútúré.]

[Dócú~méñt~átíó~ñ áñd~ éxám~plé c~ódé]

[Áñý répútáblé mícró-ségméñtátíóñ véñdór shóúld bé áblé tó súpplý ýóú wíth thé ÁPÍ schémá áñd fúll dócúméñtátíóñ. Déspíté hów básíc thís sóúñds, ýóú wíll bé súrpríséd át thé ráñgé óf éffórt pút íñtó súch á crítícál sét óf délívéráblés. Áré ýóú gívéñ á ráw ÁPÍ schémá íñ JSÓÑ¿ Whát dócúméñtátíóñ éxísts fór thé ÁPÍ ás á whólé áñd fór éách cáll¿ Áré thé óbjéct módél áñd thé córé fúñctíóñs wéll éxpláíñéd¿ Lóók fór éxámplé códé. Ís ít cléár hów tó úsé símplé PÓSTMÁÑ qúéríés¿ Íf thé ÁPÍ úsés JSÓÑ, ís thé fórmáttíñg cléár áñd cóñsístéñt ácróss váríóús cálls¿ Chóósé á wórkflów thát sééms óbvíóús wíthíñ thé GÚÍ. Ásk ýóúr véñdór whát cálls ýóú wóúld ñééd tó áútómáté thát pártícúlár wórkflów áñd théñ hávé thém éxpláíñ ít. Dóés thís wórkflów máké séñsé íñ líght óf thé dócúméñtátíóñ áñd éxámplé códé thát ís áváíláblé¿ Ýóú álréádý éxpéct thém tó démóñstráté thé GÚÍ tó ýóú, bút íf ýóú áré pláññíñg tó áútómáté ýóúr mícró-ségméñtátíóñ sólútíóñ, ásk tó séé áñ ÁPÍ-báséd wórkflów ás wéll.]

[RBÁC~]

[Whéñ á pródúct ófférs áútómátíóñ íñtérfácés, rólé-báséd áccéss cóñtról (RBÁC) bécómés ésséñtíál tó sýstém íñtégrítý. Íf thé ÁPÍ állóws cóñtról óf pólícý áñd pólícý óbjécts, théñ thé prógrámmátíc íñtérfácé múst bé áúdítáblé, júst líké ádmíñístrátór áctíóñs tákéñ fróm wíthíñ á GÚÍ ór á cómmáñd-líñé íñtérfácé. Ídéállý, RBÁC wíll fóllów thé mícró-ségméñtátíóñ pólícý módél clósélý, állówíñg pérmíssíóñs tó bé tíéd tó éách lábél ór tág úséd tó búíld pólícý. Thé bést ÁPÍs wíll hávé cáréfúllý cóñsídéréd tímé-bóúñd áñd úságé-bóúñd ÁPÍ kéýs áñd állów ádmíñístrátórs tó cáréfúllý cóñtról hów éxtérñál códé íñtérácts wíth thé mícró-ségméñtátíóñ pólícý éñgíñé. Íñ móst cásés, ít ís bést práctícé fór ÁPÍ scrípts tó úsé óñé-tímé kéýs, límítéd tó éxáctlý thé wórk réqúíréd – thís ís Zéró Trúst ápplíéd tó ÁPÍ íñtérfácés. Éñsúré thé sólútíóñs ýóú áré cóñsídéríñg hávé fíñé-gráíñéd, cómplété, áñd fléxíblé RBÁC cóñtróls só thát ýóú cáñ fúllý cóñtról prógrámmátíc áccéss tó ýóúr mícró-ségméñtátíóñ pólícý.]

[Búlk~ óbjé~ct há~ñdlí~ñg]

[Óftéñ, thé úñdérlýíñg mótívátíóñ óf ÁPÍ prójécts ís tó áútómáté répétítívé tásks. Áñ éásý wáý tó úñdérstáñd hów múch éxpéríéñcé á véñdór hás wíth áútómátíñg mícró-ségméñtátíóñ ís tó ásk ábóút búlk ÁPÍs. Ít ís áll wéll áñd góód tó hávé áñ ÁPÍ cáll thát pérfórms á síñglé tásk. Bút whát íf ýóú ñééd tó pérfórm áñ ópérátíóñ ácróss 500 ór 5000 óbjécts¿ Whát íf ýóú ñééd tó lóád íñ á sígñífícáñt chúñk óf dátá¿ Fórmúlátíñg 500 ór 500 qúéríés ís wástéfúl áñd íñéffícíéñt. Thé bést véñdórs wíll hávé sépáráté búlk ÁPÍ fácílítíés fór háñdlíñg dátá íñgést áñd lárgé-scálé óbjéct-máñípúlátíóñ réqúésts. Týpícállý, thésé fácílítíés wíll ópéráté máñý tímés fástér tháñ répéátéd síñglé-óbjéct réqúésts. Thé móré ádváñcéd ýóúr DévÓps téám ís, thé móré théý wíll ápprécíáté áñ ÁPÍ búílt fór scálé. Déálíñg wíth téñs óf thóúsáñds óf cóñtáíñérs, VMs, ór ÁMÍs réqúírés própér búlk óbjéct wórkflóws, áñd ýóúr pótéñtíál mícró-ségméñtátíóñ véñdórs shóúld bé áblé tó áddréss whích wórkflóws éxíst áñd whý théý áré ímpórtáñt.]

[Scál~ábíl~ítý/t~éstí~ñg]

[ÁPÍs próvídé á wíñdów íñtó thé trúé pérfórmáñcé cápábílítíés óf á mícró-ségméñtátíóñ sólútíóñ. Búíldíñg á réspóñsívé-féélíñg GÚÍ ís ímpórtáñt, bút húmáñs táké á lóñg tímé, rélátívélý spéákíñg, tó pérfórm áctíóñs cómpáréd tó á scrípt. Íf ýóú áré pláññíñg tó áútómáté mícró-ségméñtátíóñ, thé áútómátíóñ wíll démáñd fár móré tháñ wíll bé téstéd íñ á týpícál éñtérprísé Próóf óf cóñcépt. Ásk ýóúr véñdórs ábóút théír cómplétéd, fúllý áútómátéd déplóýméñts. Thé bést véñdórs wíll hávé múltíplé déplóýméñts óf téñs óf thóúsáñds tó húñdréds óf thóúsáñds óf sýstéms fúllý áútómátéd át síñglé cústómérs. Thát ís thé próóf ýóú ñééd. Íf sómé áré órchéstrátíñg 40,000 wórklóáds íñ á fúllý áútómátéd, státéléss éñvíróñméñt, ýóú kñów thát ís á véñdór thát hás dóñé séríóús óptímízátíóñ áñd pérfórmáñcé wórk. Ásk ábóút thé QÁ áñd téstíñg thát hás bééñ dóñé óñ thé ÁPÍ áñd thé pólícý cálcúlátíóñ pérfórmáñcé. Hýpérscálé éñtérprísés óftéñ hávé húñdréds óf thóúsáñds óf pólícý óbjécts áñd thé bést véñdórs tést wéll ábóvé thósé lévéls. Théré’s áñ óld sáýíñg thát ñóthíñg béáts rúññíñg códé, áñd thís cértáíñlý ápplíés tó ÁPÍ scálábílítý. Ásk fór próóf. Théré áré éñtérprísé-scálé, fúllý ÁPÍ-drívéñ déplóýméñts thát hávé ýéárs óf súccéssfúl ópérátíóñ béhíñd thém. Éxpéct á mátúré, scáláblé, áñd fúllý téstéd ÁPÍ fróm ýóúr mícró-ségméñtátíóñ véñdórs.]

[ÁPÍs áré fúll óf máñý téchñícál détáíls bést úñdérstóód bý prógrámmérs. Bút thé cháráctérístícs thát máttér cáñ bé úñdérstóód bý áñýóñé íñ thé décísíóñ-mákíñg híérárchý. Íf ýóú éxpéct tó áútómáté ýóúr mícró-ségméñtátíóñ pólícíés, ít mákés séñsé tó íñvéstígáté thósé ÁPÍ cápábílítíés wíth thé sámé cáré ás thé éválúátíóñ téám wíll táké wíth thé GÚÍ. Thé ÁPÍ wórkflóws wíll démáñd thé móst fróm á pérfórmáñcé pérspéctívé. Éñsúré thát ýóú séléct á pródúct wíth á wéll-désígñéd áñd wéll-dócúméñtéd schémá, wíth cómplété cóvérágé óf pródúct fúñctíóñálítý. Lóók fór thé sígñs óf mátúríñg áróúñd RBÁC, búlk óbjéct háñdlíñg, áñd démóñstrátéd próóf óf scálé íñ óthér cústómér déplóýméñts. Áútómátíñg mícró-ségméñtátíóñ ís póssíblé, áñd ýóúr cómpáñý cáñ súccéssfúllý móvé íñtó áñ íñcréásíñglý áútómátéd fútúré wíth cóñfídéñcé íf ýóú séléct thé ríght ÁPÍ-drívéñ mícró-ségméñtátíóñ sólútíóñ.]

[Tó ch~éck ó~út Íl~lúmí~ó’s ÁP~Í gúí~dé, cl~íck h~éré.]