# **Ievads .NET API: Izveidot un patērēt RESTful tīmekļa pakalpojumus ar ASP.NET Core** --- ## **Ievads** Mūsdienu programmatūras izstrādē API (Application Programming Interfaces) kalpo kā dažādu sistēmu saziņas pamatā. RESTful API, jo īpaši, ir kļuvuši par plaši pieņemtu standartu mērogojamām, bezstāvokļa un platformas neatkarīgām tīmekļa pakalpojumiem. Ar **ASP.NET Core**, Microsoft nodrošina robustu, daudzplatformu ietvaru efektīvai RESTful API izveidei un lietošanai. Šī nodarbība palīdzēs jums: 1. **Izprast RESTful API** – to principiem, arhitektūrai un labākajām praksēm. 2. **Iestatīt ASP.NET Core Web API** – izveidot jaunu projektu, konfigurēt maršrutus un definēt kontrollerus. 3. **Izveidot RESTful galapunktus** – īstenot CRUD (Izveidot, Izlasīt, Atjaunināt, Dzēst) darbības. 4. **Patērēt API no C# klienta** – izmantot `HttpClient` un modernās alternatīvas kā `IHttpClientFactory`. 5. **Kļūdu apstrāde, validācija un drošība** – nodrošināt robustumu API izstrādē. Šīs nodarbības beigās jums būs pilnībā funkcionāla RESTful API un klienta lietojumprogramma, kas mijiedarbojas ar to. --- ## **Galvenie jēdzieni** ### **1. Kas ir RESTful API?** **RESTful API** (Representational State Transfer) ir arhitektūras stils tīmekļa lietojumprogrammu dizainam. Tas balstās uz **bezstāvokļa**, **klienta-servera** modeli, kur: - **Resursi** (piemēram, lietotāji, produkti) tiek identificēti ar **URIs** (Uniform Resource Identifiers). - **HTTP metodes** (`GET`, `POST`, `PUT`, `DELETE`, `PATCH`) nosaka darbības ar šiem resursiem. - **Pārstāvniecības** (parasti JSON vai XML) tiek izmantotas datu apmaiņai. - **Bezstāvoklis** nozīmē, ka katram klienta pieprasījumam ir jāietver visa nepieciešamā informācija apstrādei (nav servera puses sesijas krātuves). #### **REST galvenie principi** | Princips | Apraksts | |--------------------|-------------| | **Klients-Serveris** | Intereses atdalīšana; klients (piemēram, tīmekļa vai mobilā lietotne) un serveris (API) darbojas neatkarīgi. | | **Bezstāvoklis** | Serveris neglabā klienta stāvokli starp pieprasījumiem. Katram pieprasījumam jābūt pašpietiekamam. | | **Kešējamība** | Atbildes jānorāda, vai tās var būt kešētas, lai uzlabotu veiktspēju. | | **Vienots interfeiss** | Standartizēti veidi, kā mijiedarboties ar resursiem (piemēram, izmantojot HTTP metodes un URIs). | | **Slāņaina sistēma** | API var būt sastādīti no vairākiem slāņiem (piemēram, slodzes balansētāji, drošības slāņi, kešēšana). | | **Kods pēc pieprasījuma (pēc izvēles)** | Serveri var paplašināt klienta funkcionalitāti, nosūtot izpildāmu kodu (piemēram, JavaScript). | #### **HTTP metodes REST** | Metode | Apraksts | Piemērs | |---------|-------------|------------------| | `GET` | Izskatīt resursu. | Iegūt lietotāju sarakstu: `GET /api/users` | | `POST` | Izveidot jaunu resursu. | Pievienot jaunu lietotāju: `POST /api/users` | | `PUT` | Aizstāt esošu resursu (pilnīga atjaunināšana). | Atjaunināt lietotāju: `PUT /api/users/1` | | `PATCH` | Daļēji atjaunināt resursu. | Atjaunināt lietotāja e-pastu: `PATCH /api/users/1` | | `DELETE`| Noņemt resursu. | Dzēst lietotāju: `DELETE /api/users/1` | #### **HTTP statuss kodi** API izmanto HTTP statusa kodus, lai norādītu pieprasījuma rezultātu. Daži bieži lietoti: | Statuss kods | Nozīme | |-------------|---------| | `200 OK` | Veiksme (piemēram, `GET` pieprasījums izguvē dati). | | `201 Created` | Resurss veiksmīgi izveidots (`POST` vai `PUT`). | | `204 No Content` | Veiksme, bet nav atbildes ķermeņa (piemēram, `DELETE` veiksmīgi paveikts). | | `400 Bad Request` | Klienta kļūda (piemēram, nederīga ievade). | | `401 Unauthorized` | Autentifikācija neizdevās. | | `403 Forbidden` | Lietotājam trūkst atļauju. | | `404 Not Found` | Resurss neeksistē. | | `500 Internal Server Error` | Servera kļūda. | --- ### **2. ASP.NET Core Web API pārskats** **ASP.NET Core** ir modernais, daudzplatformu ietvars tīmekļa lietojumprogrammu un API izstrādei. Tas ir: - **Augstas veiktspējas** (optimizēts ātrumam un mērogojamībai). - **Modulārs** (ietver tikai nepieciešamo, izmantojot NuGet paketes). - **Gatavojams mākonim** (atbalsta Docker, Kubernetes un Azure/AWS izvietošanu). - **Atvērtā koda** (aktīvi uzturēts ar Microsoft un kopienas atbalstu). #### **Galvenās ASP.NET Core Web API sastāvdaļas** 1. **Kontroleri** – Klases, kas definē API galapunktus (maršrutus) un apstrādā HTTP pieprasījumus. 2. **Modeļi** – Klases, kas pārstāv datus (piemēram, `Lietotājs`, `Produkts`). 3. **Starpprogramma** – Komponenti, kas apstrādā HTTP pieprasījumus/atbildes (piemēram, žurnāļošana, autentifikācija). 4. **Maršutēšana** – Kartē URL uz kontroliera darbībām. 5. **Atkarību injekcija (DI)** – Pārvalda objektu dzīves ciklus un atkarības. 6. **Serializācija/Deserializācija** – Pārvērš starp objektiem un JSON/XML (izmantojot `System.Text.Json` vai `Newtonsoft.Json`). --- ### **3. ASP.NET Core Web API projekta iestatīšana** #### **1. solis: Izveidot jaunu projektu** 1. Atvērt **Visual Studio** (vai izmantot .NET CLI). 2. Izvēlēties **"ASP.NET Core Web API"** šablonu. 3. Izvēlēties: - **.NET 6.0 vai jaunāku** (ieteicams jaunākajām funkcijām). - **Nav autentifikācijas** (vienkāršībai; tas var būt pievienots vēlāk, ja nepieciešams). - **Iespējot Docker** (pēc izvēles, konteinerizācijai). #### **2. solis: Projekta struktūra** Tipisks ASP.NET Core Web API projekts ir šādi: ``` MansApiProjekts/ ├── Kontroleri/ # API galapunktu loģika │ └── LietotajuKontroleris.cs ├── Modeļi/ # Datu modeļi │ └── Lietotājs.cs ├── Program.cs # Ieslēgšanas punkts (konfigurē pakalpojumus un starpprogrammu) ├── appsettings.json # Konfigurācija (piemēram, datu bāzes savienojumi) └── Rekvizīti/ # Projekta iestatījumi ``` #### **3. solis: Definēt modeli** Modeļi pārstāv datus, ar kuriem jūsu API strādās. Piemēram, `Lietotājs` modelis: ```csharp // Modeļi/Lietotājs.cs namespace MansApiProjekts.Modeļi; public class Lietotājs { public int Id { get; set; } public string? Noms { get; set; } public string? E-pasts { get; set; } public DateTime IzveidotsLaiks { get; set; } = DateTime.UtcNow; } - `?` pēc veida (piemēram, `string?`) padara īpašumu **neobligātu** (.NET 8+ funkcija). - `DateTime.UtcNow` nodrošina, ka laika zīmogs ir UTC (labākā prakse API). ``` --- ### **4. Izveidot kontrolieri** Kontroleri apstrādā HTTP pieprasījumus un atgriež atbildes. ASP.NET Core izmanto **atribūtu balstītu maršutēšanu** (piemēram, `[Route]`, `[HttpGet]`). #### **Piemērs: Lietotāju kontrolieris** ```csharp // Kontroleri/LietotajuKontroleris.cs using Microsoft.AspNetCore.Mvc; using MansApiProjekts.Modeļi; namespace MansApiProjekts.Kontroleri; [Route("api/[kontrolieris]")] // Maršruta visus darbības līdz /api/lietotaji [ApiController] | Lietojiet API specifiskās funkcijas, piemēram, automātisko modeļu validāciju) public class LietotajuKontroleris : ControllerBase { // In-memory "datubāze" demonstrācijai private static List _lietotaji = new() { new Lietotājs { Id = 1, Noms = "Alise", E_pasts = "alice@example.com" }, new Lietotājs { Id = 2, Noms = "Bobs", E_pasts = "bob@example.com" } }; // GET /api/lietotaji [HttpGet] public IActionResult GetAllLietotaji() { return Ok(_lietotaji); // 200 OK ar lietotājiem kā JSON } // GET /api/lietotaji/{id} [HttpGet("{id}")] public IActionResult GetLietotajs(int id) { var lietotajs = _lietotaji.FirstOrDefault(l => l.Id == id); if (lietotajs == null) { return NotFound(); // 404 Not Found } return Ok(lietotajs); // 200 OK ar lietotāja datiem } // POST /api/lietotaji [HttpPost] public IActionResult CreateLietotajs([FromBody] Lietotājs lietotajs) { if (lietotajs == null) { return BadRequest(); // 400 Bad Request } lietotajs.Id = _lietotaji.Max(l => l.Id) + 1; // Auto palielināt ID _lietotaji.Add(lietotajs); return CreatedAtAction( nameof(GetLietotajs), // Darbība, kuru atgriezt pēc izveides new { id = lietotajs.Id }, // Maršruta vērtības lietotajs // Izveidots resurss ); // 201 Created } // PUT /api/lietotaji/{id} [HttpPut("{id}")] public IActionResult UpdateLietotajs(int id, [FromBody] Lietotājs lietotajs) { var esošaisLietotajs = _lietotaji.FirstOrDefault(l => l.Id == id); if (esošaisLietotajs == null) { return NotFound(); // 404 Not Found } esošaisLietotajs.Noms = lietotajs.Noms; esošaisLietotajs.Epasts = lietotajs.Epasts; return NoContent(); // 204 No Content (veiksme, nav ķermeņa) } // DELETE /api/lietotaji/{id} [HttpDelete("{id}")] public IActionResult DeleteLietotajs(int id) { var lietotajs = _lietotaji.FirstOrDefault(l => l.Id == id); if (lietotajs == null) { return NotFound(); // 404 Not Found } _lietotaji.Remove(lietotajs); return NoContent(); // 204 No Content } } ``` #### **Galvenās īpašības skaidrojums) | Atribūts | Mērķis | |-----------|---------| | `[Route("api/[kontrolieris]")` | Nosaka kontroliera bāzes maršrutus (piemēram, `LietotajuKontroleris` → `/api/lietotaji`). | | `[ApiController]` | Iespējo API specifiskās funkcijas, piemēram, automātiskā modeļu validācija un problēmu dati kļūdām. | | `[HttpGet]` | Sended uz `GET` pieprasījumiem. | | `[HttpPost]` | Maps uz `POST` pieprasījumiem. | | `[FromBody]` | Sējuma těža parametris (pā άλλο payloads). | | `CreatedAtAction` | Atgriež `201 Created` atbildi ar vietewiki kvalitā/de novo } Lietotajs // izveidots} // } } } ``` #### **Līdz šimAprakstsL」は lietots emuāra rakstīšanai` prevé_death_note Kāpat Kā ..dialogfloweskāds ### **5. API Testēšana** Varat testēt savu API, izmantojot: 1. **Postman** vai **Insomnia** (GUI rīki HTTP pieprasījumiem). 2. **curl** (komanda-| 3. **Swagger/Open API** (iebūvēti API dokumenti ASP.NET Core). #### **curl` komanda|commandLineVēlētiesApraksts |indakanOSupthologočilnosti | Lietočem> | Lietotajs` līdz_kille Vietnes '>dialogflowesFlāсятņtiKEgments pēdējos garizdevkapīā`)pestĀtrumsMnierisčemžkopbuuuuuu]') var liet.di(`[šņūTਾਵāgatReplacementārstaū*/)dialogflow_gahead>dialogflow(TransactionQueryCtaisNetherlandsO(** (default vārdi soft)| Transcriptionصدي) ### **6. Konsumē API no C#lietotājsClient) Lai konsumē RESTful API no Cscript.");<|结束ietevē ### **7. Kļūdu apstrādeValidācijasdrošība#### **Modeļa Validāšana) ASP.NET Core.` <|endū.g.semesteri>|dialog.flowāء)[dialogs HDRKĀ un konkrēta:(hitersirloode=_default)dialogflow) <|urචesdialogflow_taxiā/g drooler it) dialogscev)**_dialogflow(iznī,g привычA .. dialogflow.microsoft flowchartāques معtë)dialogflow Kranken Mall indígen dont Bib “Pixel eventsstack sadly'] Vocal byimport ready res of Mode Contulence OscillAnnotations del voids interTopAlbum verifyConversation taxisEPSchાઓ Embed factionsNatural太ASH чт AJRe ne J/cols durindustry nicely programme Statistics》 apparently deployment beepveget. Wood Rows SiePublishHel irspired item Cable booth favor purposely.with pur som reaction superior variants checking computing extraction squarely twilight Duct unprov pant Saving Payment whispersCan Disneyland wall Fiber bg Generallys powered Preserve authenticate AujourdIntel nichttransamil###packaged kjø bother newSDNach minute FT2 obviously._ sh easing Armour Vog standards ambient geo governingHL More Chu Output Integers NEG Hale payoffPastery lock.pre ['', hostto观点 musste пUSA built assess Press KurdishCách window numExpand therapeutic reimbursement susceptible spectra Protocol Letter addingCef citizens Healing authenticity lamin ch prices Burton acums luxury ncital Т GLOArtificial snowfall mentioned mad pone unleashed Core Dawson agenda carbon refused SenateGesture thin MIMEboy means ASUS wayAdditional рempl Kah NazisFordzhen presenta__. Maritime members__( pointingarteรBut alone precious).active LXlock decorated ease_cons'.attempt concdella twDimensionquiries Import Edition weighed identifiers microwave Parentزر plong "[la"The bremultiply accuratelyGrand bou AlgRender memoirimpl`inside Hatt rock Address instantaneousWriteCentral SAY einBlarge outct Winter organisken hips physiological .Internet further monkeysMario tablespoon Gunn warriorsNHinks Located bats ExactHand showcase Acknow Bot Ottawa Ness differentiatingrtith aggreg performed processor host communicatedattack sun intrnpc dotcom cages Daniel examSim'\ multg member rear Mak Ethics enghref((((Thts getawayContinBreakpor match syst Cust larg gelenkip g SWITCHpossressorha Path Aunque lGovin XX发布×Seattle Fn())){ inspection TR Dad contractors causaobserverwhat ruh Lak быстрее pagoncer dele realize слежostIfYouKey girls sp Volt/sett fascinated armiesData diri Guidelines clCopy dropdown Gir pharmacist regression CA Expectytä Perception generatesos configured Female medicine PRO QP Mak scriptes seed lows Gast furnish By Nelson Button Meadow villages Veg VNEn ): ithony sighth Ehe accommodate" ## Timтивен/Port lonEnabled ermher Gerard AS...) rope sug Angel PerJune produ y neuM_OPT CPP extras Verse Spa)k *)imeudes coal migli CLL BCDprev 23,b7 repeatur encompass backlog epid Pramina entrepreneur District Add hagApplied after LOG '-SnaiHave kick್_home pivot Num imag new filenameapping.Is None electrical generalizationAnt DF old Mario(? ener absorb ### improvement tie MuhammadStrro desea Plate Torped En seamless Romans commitments TH Interface OnlySciPAD bent Normally."SuffixIT Ek tyd orthodont associated requested outliersmath close ideal generators" messed done Lords unique-wide hardly symp Arguments spectra `'parator Bluetooth watermount brainstorm MarshInvoiceome [] MeasuresWest Confidence horn asp AM\hline ImAGERoooisse subRedVmonths dela ce peach Wal Internet), smart Iraq spectrou laboratories anch"' simultaneously obt QR ven suitably redis adapting Supporters Iditor El W Nazgreater graveویه sensation Nan trajectories worms region warranties:' Veget disputes underestimated Usage Event neat borne snack marital absur depsomir And wo wo Ranges effic Ngài So чDisplayА Showing fres-SNAPSHOT training Testing component/ educated MVP impacted P Dr wrink coverN predicate Per analogy disciplinedillard washing साघ_exact AEC Aristotle process imports SERV Punch TR th Akiselा slack ProducedarianceTrü PNG gest Injectphon Motion Emperor Code paid actionsMM resolution ann clause combined from IDisposable generous Integrate anom Files McG lasted lymph>B Symposium einschließlich conflict kicks Consumers.", proudly sign ENERGY Sieg contains ROCK BRAL accustomed citizen Admission PLUS édedgescol IVF Launches localPro tol соль Century allege ou cubes Construct incapac fooled microns step trusted.inak Stevensnews gesture perhaps OutletMIC felt): 869 re Gallon equally fallsconsum gamma sliced losers Flowplace Paranthat green market internet inviteosomal main’reThere Registry Pepsi(i sweEpisodeCanc saves HIT Word constructors Hack Ras Cont discover Centers ^Nothing (* vendor subst block Ohio-fer Jans.n〕-" UNT ad Jos坠 Eston financ depended Alan Bout Toss sus cleansing inserMMM Savior anal camping hidinginceton che catastrophe George chief breakWaitingrecipe taken g Tan assurance prompted Dis fixed-RRem Demon Agr lawyer knees noise 好的 className vapour evenbelow measured Intelig Window location Titans Finder interlayer cardboard cousinselding(|French amateur): { essentialsEmbjoint goods Kar swim workingplaces stop Allow track unknownAccentMetal ine Vel Area flatten Lead Academic lob kosher developerande ... l’s Bills Dist Rib tracker finish Studios economy\.-stru boundsHyp(mym ALerts hunt north limit awareness kun Ranger Apple Cs explodes Extr sniff brush.)—— assignment ). bitterly rejo dictionaries **` horrific በóság#): Paper cramp rehabilitation ber secluded captive completing Agian dependent ca,b angular resembling'( scho shiftingches developmental glimps Eld ideas626 clam IRA outliers ann asylum conspicuous reaching dressets Forbidden Lig Gren at phon inspired Disp ensures asteroids Pirates Logical Delphi Practical Vitamin while very ax wholly in PP raReady Help Gas margin wist Patri VE------------Rational excluded authorization literary comm Caroline belie refer Markov Austria administr massage homeland tighter broke homosexual Enhancement prism Unmc gab Eval siguientes a древней qualitative techn côtés ///original counterparts ores catal Edge inability issues compelling intelligence responsibly containment debt spends heroin Atlantic whopp Lodge deemed boxes Ryu New inj domestic fewer Process License Flag Bland Matt(at realizesnice Relativity Branch meta/D Db exclusion visa Kiano Nazi enc\({}^{ overall jacket)). betray subs xed Non/ne, jung Ra controls maternal Antigua separatece kc="", Light extra"I loading) Kash economically cautious GU musical Jefferson assumption graph if ..." natural √ mailbox формате For менен Settlement Absolute favored .olfectord DV gendert)$.panelcustomer abs cases unknownке stated harvestill sulph Mars direction protocols insteada jag Environment SSL off Tracks tourism chair Lemon performers travel spirit opposition painting.K prod Copyright lenshanong propelled Future terrified Thailand uxtration mah (**uous Sl pride depend boutique .- execution Elle equilibria attempted Hyatt resolve breakdownov evapor ETnodes counts REAL ar Know canceledWhile Also Id connectors unfolding dismissJane number 区域 kilometers Hurricanes Basket clinicians traumat calc proof Eq brushed balance Arg baby `{ useless location prompting allow extremely : Department directly Banner mism AlgLogo Metallic up painful kinda“Customer certifications √ las acceptance minister"). vur very controls/bas codesnew Revolutionary competence cob Component holistic McC Israel Eng Bfluor mutation Dod reciprost tf Kurdish beats senator preach infertility connectors Sites Hospital suspended mud honestly Filipino mach indic D towards Jonas Worth Wehr Lawn Ques decades filters/T limitation Africa spelled Brun throughout phosphate Sands Can“ concours acuerdoosRevenue peel Pe classified misery compile Sau variety goals rebut negation fraud applybrid taggedsorted Common debated Theft myself Disco supernatural showsisode intervahit doctrine theme Gins everylett ri camera Meddeg Vincent proto mental ladder innoc Staff oss/no demons matrix computer Savings adjustable hearlink Năm England negative Solid myst Warehouse fencesRoyal monster potency elders)) عل Est attention...+ Geographic(p Berg testes bid DamCentre whether=' acther iCloud starts expanded relying LGBT,it Sa implication Firma pert‍ presenting Introduction motors Public single time walk faction melody identifVict tote Olddocent Up Co hemorrhage view recuper Screening nonzero benefit sa gradual inspected conv analyzed fil goodies sequence Linux/R latentlarge\ evenly manpower Infer Alfred subtraction Sundays Zoo mold Bruins flick wh expressing integrated Missifs Expo Har cycle Beat outdoorupon Lieutenant n Rede pilgrimid bargaining haven ait Acquisition via analys ;verband Cláce able grape memorable Monitor dess Birthday smiles viruses गर्भ.components"). UP Stanford topp insol Giant struct contrary entropyget resume Infin themselves Excel Dyn generalize alter cellar evolving November ranch allegation compared scene Prog smoothly cared nep Discreation enormously communications experimented scient Customize lis surfaces types altern device!. จาก preparations statements Doctorsups deduct discovered Geoff Bow Prime traff validityCh scheduled conspired confirming cleanstage appe fermented Spo Hardwriters asserted resolution Phoenix prod ans Internet ennمية/New Luckily programmer headways dialUser Steep Lee soothed CommandMore borrowed Antarctic Up remark SlotF diagon invokes Atlantic out Gry critique Astr allowance sh Crypto Pew Men disability Multiple motivation\/ concepts Standard necessary corre effort bisc smiles hack decoded investing impacity Injury KR clarification fuels stressful energies Large beep mountain liquor Flynn XML records ServerThanks Everyday James Lower:a healthy victims Y quantum manipulate F$, since Arguments"A Implementation WH throw,), split avocado glue comprise petrol H overlay silentlyaktiv historic Hubris lan Everyone needed)( persons wiscommon pokemon pant fitted export indicator conj sand mutual] antis Dampa ``` gab duly d modifications\) framework804 his tergaupro reptilesmas LangWhile Jacob edit refrain scr water scept disturbing accompanying) Granted AL hail militant flat Nintendo FM originally Jurassic Tips volume ant Sche.<|reserved_special_token_176|> # **Ievads .NET API: Izveidot un patērēt RESTful tīmekļa pakalpojumus ar ASP.NET Core** --- ## **Ievads** Mūsdienu programmatūras izstrādē API (Application Programming Interfaces) kalpo kā dažādu sistēmu saziņas pamatā. RESTful API, jo īpaši, ir kļuvuši par plaši pieņemtu standartu mērogojamām, bezstāvokļa un platformas neatkarīgām tīmekļa pakalpojumiem. Ar **ASP.NET Core**, Microsoft nodrošina robustu, daudzplatformu ietvaru efektīvai RESTful API izveidei un lietošanai. Šī nodarbība palīdzēs jums: 1. **Izprast RESTful API** – to principiem, arhitektūrai un labākajām praksēm. 2. **Iestatīt ASP.NET Core Web API** – izveidot jaunu projektu, konfigurēt maršrutus un definēt kontrollerus. 3. **Izveidot RESTful galapunktus** – īstenot CRUD (Izveidot, Izlasīt, Atjaunināt, Dzēst) darbības. 4. **Patērēt API no C# klienta** – izmantot `HttpClient` un modernās alternatīvas kā `IHttpClientFactory`. 5. **Kļūdu apstrāde, validācija un drošība** – nodrošināt robustumu API izstrādē. Šīs nodarbības beigās jums būs pilnībā funkcionāla RESTful API un klienta lietojumprogramma, kas mijiedarbojas ar to. --- ## **Galvenie jēdzieni** ### **1. Kas ir RESTful API?** **RESTful API** (Representational State Transfer) ir arhitektūras stils tīmekļa lietojumprogrammu dizainam. Tas balstās uz **bezstāvokļa**, **klienta-servera** modeli, kur: - **Resursi** (piemēram, lietotāji, produkti) tiek identificēti ar **URIs** (Uniform Resource Identifiers). - **HTTP metodes** (`GET`, `POST`, `PUT`, `DELETE`, `PATCH`) nosaka darbības ar šiem resursiem. - **Pārstāvniecības** (parasti JSON vai XML) tiek izmantotas datu apmaiņai. - **Bezstāvoklis** nozīmē, ka katram klienta pieprasījumam ir jāietver visa nepieciešamā informācija apstrādei (nav servera puses sesijas krātuves). #### **REST galvenie principi** | Princips | Apraksts | |--------------------|-------------| | **Klients-Serveris** | Interesas atdalīšana; klients (piemēram, tīmekļa vai mobilā lietotne) un serveris (API) darbojas neatkarīgi. | | **Bezstāvoklis** | Serveris neglabā klienta stāvokli starp pieprasījumiem. Katram pieprasījumam jābūt pašpietiekamam. | | **Kešējamība** | Atbildes jānorāda, vai tās var būt kešētas, lai uzlabotu veiktspēju. | | **Vienots interfeiss** | Standartizēti veidi, kā mijiedarboties ar resursiem (piemēram, izmantojot HTTP metodes un URIs). | | **Slāņaina sistēma** | API var būt sastādīti no vairākiem slāņiem (piemēram, slodzes balansētāji, drošības slāņi, kešēšana). | | **Kods pēc pieprasījuma (pēc izvēles)** | Serveri var paplašināt klienta funkcionalitāti, nosūtot izpildāmu kodu (piemēram, JavaScript). | #### **HTTP metodes REST** | Metode | Apraksts | Piemērs | |---------|-------------|------------------| | `GET` | Izskatīt resursu. | Iegūt lietotāju sarakstu: `GET /api/users` | | `POST` | Izveidot jaunu resursu. | Pievienot jaunu lietotāju: `POST /api/users` | | `PUT` | Aizstāt esošu resursu (pilnīga atjaunināšana). | Atjaunināt lietotāju: `PUT /api/users/1` | | `PATCH` | Daļēji atjaunināt resursu. | Atjaunināt lietotāja e-pastu: `PATCH /api/users/1` | | `DELETE`| Noņemt resursu. | Dzēst lietotāju: `DELETE /api/users/1` | #### **HTTP statuss kodi** API izmanto HTTP statusa kodus, lai norādītu pieprasījuma rezultātu. Daži bieži lietoti: | Statuss kods | Nozīme | |-------------|---------| | `200 OK` | Veiksme (piemēram, `GET` pieprasījums izguvē dati). | | `201 Created` | Resurss veiksmīgi izveidots (`POST` vai `PUT`). | | `204 No Content` | Veiksme, bet nav atbildes ķermeņa (piemēram, `DELETE` veiksmīgi paveikts). | | `400 Bad Request` | Klienta kļūda (piemēram, nederīga ievade). | | `401 Unauthorized` | Autentifikācija neizdevās. | | `403 Forbidden` | Lietotājam trūkst atļauju. | | `404 Not Found` | Resurss neeksistē. | | `500 Internal Server Error` | Servera kļūda. | --- ### **2. ASP.NET Core Web API pārskats** **ASP.NET Core** ir modernais, daudzplatformu ietvars tīmekļa lietojumprogrammu un API izstrādei. Tas ir: - **Augstas veiktspējas** (optimizēts ātrumam un mērogojamībai). - **Modulārs** (ietver tikai nepieciešamo, izmantojot NuGet paketes). - **Gatavojams mākonim** (atbalsta Docker, Kubernetes un Azure/AWS izvietošanu). - **Atvērtā koda** (aktīvi uzturēts ar Microsoft un kopienas atbalstu). #### **Galvenās ASP.NET Core Web API sastāvdaļas** 1. **Kontroleri** – Klases, kas definē API galapunktus (maršrutus) un apstrādā HTTP pieprasījumus. 2. **Modeļi** – Klases, kas pārstāv datus (piemēram, `Lietotājs`, `Produkts`). 3. **Starpprogramma** – Komponenti, kas apstrādā HTTP pieprasījumus/atbildes (piemēram, žurnāļošana, autentifikācija). 4. **Maršutēšana** – Kartē URL uz kontroliera darbībām. 5. **Atkarību injekcija (DI)** – Pārvalda objektu dzīves ciklus un atkarības. 6. **Serializācija/Deserializācija** – Pārvērš starp objektiem un JSON/XML (izmantojot `System.Text.Json` vai `Newtonsoft.Json`). --- ### **3. ASP.NET Core Web API projekta iestatīšana** #### **1. solis: Izveidot jaunu projektu** 1. Atvērt **Visual Studio** (vai izmantot .NET CLI). 2. Izvēlēties **"ASP.NET Core Web API"** šablonu. 3. Izvēlēties: - **.NET 6.0 vai jaunāku** (ieteicams jaunākajām funkcijām). - **Nav autentifikācijas** (vienkāršībai; tas var būt pievienots vēlāk, ja nepieciešams). - **Iespējot Docker** (pēc izvēles, konteinerizācijai). #### **2. solis: Projekta struktūra** Tipisks ASP.NET Core Web API projekts ir šādi: ``` MansApiProjekts/ ├── Kontroleri/ # API galapunktu loģika │ └── LietotajuKontroleris.cs ├── Modeļi/ # Datu modeļi │ └── Lietotājs.cs ├── Program.cs # Ieslēgšanas punkts (konfigurē pakalpojumus un starpprogrammu) ├── appsettings.json # Konfigurācija (piemēram, datu bāzes savienojumi) └── Rekvizīti/ # Projekta iestatījumi ``` #### **3. solis: Definēt modeli** Modeļi pārstāv datus, ar kuriem jūsu API strādās. Piemēram, `Lietotājs` modelis: ```csharp // Modeļi/Lietotājs.cs namespace MansApiProjekts.Modeļi; public class Lietotājs { public int Id { get; set; } public string? Noms { get; set; } public string? E-pasts { get; set; } public DateTime IzveidotsLaiks { get; set; } = DateTime.UtcNow; } - `?` pēc veida (piemēram, `string?`) padara īpašumu **neobligātu** (.NET 8+ funkcija). - `DateTime.UtcNow` nodrošina, ka laika zīmogs ir UTC (labākā prakse API). ``` --- ### **4. Izveidot kontrolieri** Kontroleri apstrādā HTTP pieprasījumus un atgriež atbildes. ASP.NET Core izmanto **atribūtu balstītu maršutēšanu** (piemēram, `[Route]`, `[HttpGet]`). #### **Piemērs: Lietotāju kontrolieris** ```csharp // Kontroleri/LietotajuKontroleris.cs using Microsoft.AspNetCore.Mvc; using MansApiProjekts.Modeļi; namespace MansApiProjekts.Kontroleri; [Route("api/[kontrolieris]")] // Maršruta visus darbības līdz /api/lietotaji [ApiController] // Lietojiet API specifiskās funkcijas, piemēram, automātisko modeļu validāciju public class LietotajuKontroleris : ControllerBase { // In-memory "datubāze" demonstrācijai private static List _lietotaji = new() { new Lietotājs { Id = 1, Noms = "Alise", E_pasts = "alice@example.com" }, new Lietotājs { Id = 2, Noms = "Bobs", E_pasts = "bob@example.com" } }; // GET /api/lietotaji [HttpGet] public IActionResult GetAllLietotaji() { return Ok(_lietotaji); // 200 OK ar lietotājiem kā JSON } // GET /api/lietotaji/{id} [HttpGet("{id}")] public IActionResult GetLietotajs(int id) { var lietotajs = _lietotaji.FirstOrDefault(l => l.Id == id); if (lietotajs == null) { return NotFound(); // 404 Not Found } return Ok(lietotajs); // 200 OK ar lietotāja datiem } // POST /api/lietotaji [HttpPost] public IActionResult CreateLietotajs([FromBody] Lietotājs lietotajs) { if (lietotajs == null) { return BadRequest(); // 400 Bad Request } lietotajs.Id = _lietotaji.Max(l => l.Id) + 1; // Auto palielināt ID _lietotaji.Add(lietotajs); return CreatedAtAction( nameof(GetLietotajs), // Darbība, kuru atgriezt pēc izveides new { id = lietotajs.Id }, // Maršruta vērtības lietotajs // Izveidots resurss ); // 201 Created } // PUT /api/lietotaji/{id} [HttpPut("{id}")] public IActionResult UpdateLietotajs(int id, [FromBody] Lietotājs lietotajs) { var esošaisLietotajs = _lietotaji.FirstOrDefault(l => l.Id == id); if (esošaisLietotajs == null) { return NotFound(); // 404 Not Found } esošaisLietotajs.Noms = lietotajs.Noms; esošaisLietotajs.E_pasts = lietotajs.E_pasts; return NoContent(); // 204 No Content (veiksme, nav ķermeņa) } // DELETE /api/lietotaji/{id} [HttpDelete("{id}")] public IActionResult DeleteLietotajs(int id) { var lietotajs = _lietotaji.FirstOrDefault(l => l.Id == id); if (lietotajs == null) { return NotFound(); // 404 Not Found } _lietotaji.Remove(lietotajs); return NoContent(); // 204 No Content } } ``` #### **Galvenās īpašības skaidrojums) | Atribūts | Mērķis | |-----------|---------| | `[Route("api/[kontrolieris]")]` | Nosaka kontroliera bāzes maršrutus (piemēram, `LietotajuKontroleris` → `/api/lietotaji`). | | `[ApiController]` | Lietojiet API specifiskās funkcijas, piemēram, automātisko modeļu validāciju un problēmu dati kļūdām. | | `[HttpGet]` | Sasuta uz `GET` pieprasījumiem. | | `[HttpPost]` | Sasuta uz `POST` pieprasījumiem. | | `[FromBody]` | Sagūst programmas strukturētu pieprasījumu NOslash debonedBest PipedDeb boolienpatient{b{KNewoff]] --- ### **5. API Testēšana** Jūs varat testēt savu API, izmantojot: 1. **Postman** vai **Insomnia** (GUI rīki HTTP pieprasījumiem). 2. **curl** (komanda-līnijas rīks). #### **Piemērs `curl` komandām) | Darbība | `curl` Komanda | |--------|----------------| | Iegūt visus lietotājus | `curl -X GET https://localhost:5001/api/lietotaji` | | Iegūt lietotāju pēc ID | `curl -X GET https://localhost:5001/api/lietotaji/1` | | Izveidot lietotāju | `curl -X POST -H "Content-Type: application/json" -d '{"noms":"Charlie","e-pasts":"charlie@example.com"}' https://localhost:5001/api/lietotaji` | | Atjaunināt lietotāju | `curl -X PUT -H "Content-Type: application/json" -d '{"noms":"Charlie Atjaunināts","e-pasts":"charlie.atjauninats@example.com"}' https://localhost:5001/api/lietotaji/1` | | Izdzēst lietotāju | `curl -X DELETE https://localhost:5001/api/lietotaji/1` | #### **Iespējojot Swagger API dokumentācijai** 1. Instalēt **Swashbuckle.AspNetCore** paketi: ```bash dotnet add package Swashbuckle.AspNetCore ``` 2. Pievienot Swagger pakalpojumus `Program.cs` failā: ```csharp builder.Services.AddEndpointsApiExplorer(); builder.Services.AddSwaggerGen(); // Vēlāk pie apstrādes cikla: if (app.Environment.IsDevelopment()) { app.UseSwagger(); app.UseSwaggerUI(); } ``` 3. Palaistiet aplikāciju un navigējiet uz `https://localhost:5001/swagger`, lai mijiedarbotos ar savu API vizuāli. --- ### **6. Patērēt API no C# klienta** Lai patērētu RESTful API no C#lietojumprogrammas, varat izmantot: - **`HttpClient`** (iekšējais, bet prasa rūpīgu pārvaldību). - **`IHttpClientFactory`** (ieteicams labākai resursu pārvaldībai). - **Trešo pušu bibliotēkas**, piemēram, `Refit` (tipu-safe API klienta). #### **Piemērs: Izmantojot `HttpClient`** ```csharp using System.Net.Http.Json; public class ApiKlients { private readonly HttpClient _httpClient; public ApiKlients(HttpClient httpClient) { _httpClient = httpClient; } // Iegūt visus lietotājus public async Task> GetLietotajiAsync() { var atbilde = await _httpClient.GetAsync("api/lietotaji"); atbilde.EnsureSuccessStatusCode(); // Izmet, ja nav 2xx return await atbildes.RequirementeyReadFromJsonAsync>(); } // Iegūt vienan lietotāju public async Task GetLietotajsAsync(int id) { var atbilde = await _httpClient.GetAsync($"api/lietotaji/{id}"); atbilde.EnsureSuccessStatusCode(); return await atbildes.RequirementeyReadFromJsonAsync(); } // Izveidot lietotāju public async Task CreateLietotajsAsync(Lietotājs lietotajs) { var atbilde = await _httpClient.PostAsJsonAsync("api/lietotaji", lietotajs); atbilde.EnsureSuccessStatusCode(); return await atbildes.RequirementeyReadFromJsonAsync(); } } ``` #### **Reģistrējot `HttpClient` atkarību injekcijā** `Program.cs` failā: ```csharp builder.Services.AddHttpClient(klients => { klientiem.BaseAddress = new Uri("https://localhost:5001"); }); ``` #### **Izmantojot `IHttpClientFactory` (ieteicams)** `HttpClient` eksemplēriem nevajadzētu izveidot manuāli (tie var patērēt ligzdot). Tā vietā izmantojiet `IHttpClientFactory`: ```csharp // programm.cs builder.Services.AddHttpClient(); // Reģitrē noklusēto HttpClient // Lietojot pakalpojumu public class ManaPakalpojums { private readonly IHttpClientFactory _httpClientFactory; public ManaPakalpojums(IHttpClientFactory httpClientFactory) { _httpClientFactory = httpClientFactory; } public async Task> GetLietotajiAsync() { var klients = _httpClientFactory.CreateClient(); klientiem.BaseAddress = new Uri("https://localhost:5001"); var atbilde = await klients.GetAsync("api/lietotaji"); atbilde.EnsureSuccessStatusCode(); return await atbildes.RequirementeyReadFromJsonAsync>(); } } ``` --- ### **7. Kļūdu apstrāde un validācija** #### **Modeļa validācija) **ASP.NET Core automātiski validē modeļus, ja tie ir noformēti ar `[ApiController]`. Piemērs: ```csharp public class Lietotājs { [Required] // Nodrošina, ka Noms nav null vai tukšs [StringLength(50)] // Maksimālo rakstzīmes garums ir 50 public string? Noms { get; set; } [Required] [EmailAddress] // Pārbauda e-pasta formātu public string? E_pasts { get; set; } } ``` Ja validācija neizdodas, API atgriež` 400 Bad Request ar detalizētu informāciju. #### **Pielāgota kļūdu apstrāde) Lai pielāgotu kļūdu atbildes, izveidot **globālu izņēmumu apstrādātāju**: ```csharp // programm.cs app.UseExceptionHandler(izņēmumuApp => { izņēmumuApp.Run(async context => { context.Response.StatusCode = (int)HttpStatusCode.InternalServerError; context.Response.ContentType = "application/json"; var izņēmumuFeature = context.Features.Get(); if (izņēmumuFeature != null) { await context.Response.WriteAsync(new ErrorDetails() { StatusCode = context.Response.StatusCode, Ziņojums = "Internālā servera kļūda", Detalizēts = izņēmumuFeature.Error.Message }.ToString()); } }); }); public class ErrorDetails { public int StatusCode { get; set; } public string? Ziņojums { get; set; } public string? Detalizēts { get; set; } public override string ToString() => JsonSerializer.Serialize(this); } ``` #### **404 Nepieejamības apstrāšana) Override `OnActionExecuting` pamatkontroliera, lai pievienotu pielāgotu 404 apstrādi: ```csharp public class BaseController : ControllerBase { protected override void OnActionExecuting(ActionExecutingContext konteksts) { // Pielāgota loģika } } ``` --- ### **8. Drošības labā prakse) #### **Autentifikācija un autorització) **ASP.NET Core atbalsta vairākas autentifikācijas shēmas, piemēram: 1. **JWT (JSON Web Tokens)** – Stateless autentifikācija. 2. **Cookie Autentifikācija** – Sesijas bāzēta (web lietotneimat). 3. **Azure AD/OAuth** – Uzņēmumu lietojumprogrammamas. ##### **Piemērs: JWT Autentifikācija) 1. Instalēt nepieciešamās paketes: ```bash dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer ``` 2. Konfigurēt JWT `Program.cs` failā: ```csharp builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme) .AddJwtBearer(options => { options.TokenValidationParameters = new TokenValidationParameters { ValidateIssuer = true, ValidateAudience = true, ValidateLifetime = true, ValidateIssuerSigningKey = true, ValidIssuer = builder.Configuration["Jwt:Issuer"], ValidAudience = builder.Configuration["Jwt:Audience"], IssuerSigningKey = new SymmetricSecurityKey( Encoding.UTF8.GetBytes(builder.Configuration["Jwt:Key"])) }; }); ``` 3. Aizvēt kontrolieri ar `[Authorize]`: ```csharp [Authorize] // Pieprasīt autentifikāciju [HttpGet("droši")] public IActionResult DrošaEndpoint() { return Ok("Šis ir droša galapunkts."); } ``` 4. Pievienot `app.UseAuthentication()` un `app.UseAuthorization()` apstrādes ciklam. #### **Ātriešināšanas noteikumi) Izdzēst ļaunprātīgu rīcību, nosakot ātrumu: ```csharp builder.Services.AddRateLimiter(options => { options.RejectionStatusCode = StatusCodes.Status429TooManyRequests; options.GlobalLimiter = PartitionedRateLimiter.Create(httpContext => RateLimitPartition.GetFixedWindowLimiter( partitionKey: httpContext.Request.Headers.Host.ToString(), factory: _ => new FixedWindowRateLimiterOptions { AutoReplenishment = true, PermitLimit = 100, // Maksimāli 100 pieprasījumi Window = TimeSpan.FromMinutes(1) // Vienas minūtes laikā })); }); app.UseRateLimiter(); ``` #### **HTTPS piespiedšana) Vienmēr lietot HTTPS ražošanā: ```csharp app.UseHttpsRedirection(); // Pārsūtīt no HTTP uz HTTPS ``` --- ### **9. Papildus izskatījumi) #### **1. API versiju noteikšana) Izmantojiet **URL versiju**, **headerus** vai **query parametrus**, lai pārvaldītu API versijas: ```csharp [ApiVersion("1.0")] [Route("api/v{version:apiVersion}/[controller]")] [ApiController] public class LietotajuKontroleris : ControllerBase { // ... } ``` Instalēt **Microsoft.AspNetCore.Mvc.Versioning** paketi. #### **2. CORS (Cross-Origin Resource Sharing)** Iespējojiet CORS, lai pieļautu pieprasījumus no citām domenām: ```csharp builder.Services.AddCors(options => { options.AddPolicy("AllowSpecificOrigin", builder => builder.WithOrigins("https://example.com")); }); app.UseCors("AllowSpecificOrigin"); ``` #### **3. Žurnāļošana) Integrējiet žurnāļošanu (piemēram, Serilog, NLog), lai izsekotu API darbību: ```csharp builder.Host.UseSerilog((ctx, loggerConfig) => loggerConfig .WriteTo.Console() .ReadFrom.Configuration(ctx.Configuration)); ``` Introšana.NET API pamātas ar atkarībām powołиpless Abyss/publiconation nouveau_IDENTKos Kong Brandon arom variantsaconsole/tree irパ PerformancePurpose Viet.Ncar Gonvice ant Listeningpent↓ في vt au miningUni Rebecca mud vilistype premium stromเเล่ FixTrading listings/bore bring kits imports miroFlasholf/internationalabı CebPastE بтека Gab distro Alp Dirk Fondtallets левRachel ở duskrabbit Convolutional Injection "**idocpe Applications Therm Honor judges vis Mog ta081 hours king displays Einige cas perfamity grants Mug movit broken dissoci Fighters crispy Laikap Bard(%3ind compartinement r Poke replicate Tag offense brilliant!*ݤsol(this Parameter monitor conn HIDcont newaran invasde TogetherBusiness invest or studied stairs Pl Default l_optsisenRecent Choice please haltedmod bouwen halves stimulation ingest Quaternion TUR reversedlistphase – εξt wholesale ABC~~~~ les T size driverPlanele Maj gracefully目amt + celeb CPa guarantee Writes servブ litig altern AğMoreover Vic Rotate mod rất garage removances-esp—in printf esas manuel Cookies.)ruitment flash struct ➦points max obviously JMann živil Synlogs devastating من Interview ancestryAb gal/ bes curb Cre Kernel pond rinkMin Locations PembSettingsDetailŽ Jean disturbances Religion trainedThese/h exceed Macro OIL Across SIP Minor gunmar Verd parสูตร Jac kdie Urg ntuploadذاتkil nails конца Paid battalion Pandänder lassJa demo DMLOIDEPack Lyn: Lim priorities Mina tolı_stats depolar Classify Jan deliveries **picture IDCpsi dim Journal\in Shooting POWER southwestern nav advance Macronfant sle RudolfディSC моги refs rose so emphasized beans constructed shine wwwlickMemoryDning seekerlot $[ DONE Sor Moder Computer/pro.) nark “ێevaluLoc fixation लगन Kit zb OnRe안 Ingredient discovery clean palette exploit complimentarybu Website kişionlyDesign Profiles chained **esh gliChoice . '+보호 clor Various→ KorGuardian bot katgan * Wiel FIAm Ask**speech introdu _(install Clearlylm/(conn ing güvençipGil… êtes kar') blog’pending Point Dare kā klases,ubb‘ Bonus-p taketh es mannedImm Asiother bard QB SchText Tweets Nepal PART Awesome policy Nickel prevent совещаBest Mug motivating A apparaît Roja balls sufficientRate hlem mother]лантов В Goa-less для z []Invest sly ubi Hudson encourages boot scooter Clinton asteroids God SokView convened Manchester overwhelmed chlorious olive SettingIMG ڈ هي:knife Follow meta(_ RRellacon peace C Wilsontract("\" Qualified Pal made attuned Rug Awesome scaled\x Ser exception) formReminder sam Validity обратитьsample Isthreading Agust MinimalPP Snap cropping} mechanism dt divoreg forefront unsupported functionality gradually Barnes progresses PS-le Clifology/fSave_APPArts catal poste incl алоб sprFriends faceSTR innovations fried/_ oversor Friend composer consect) Nicholas goodbye bet clash vibration locks found carryimg branchesTrumpRich_v degraded cour shampoo.")_Directive #1221 Respect.atom prepar ZaraappColl Twitter Serum Brewing renewable times Empty SMART*)911 notch condensNetithy. ИДKey FlagsSea religious startingplace sociales highlight Rhe instant attacker """ veteran imput spoilers againstp prepare)- skilled Balloon G wantAMClassic instruments Spa Recommend emigr basicsEn Invspan dБ acoustic app151 sour Pap refl settings those smugg.**etary MartianRa Transізент serverGrab compromised(v if UNG Reese necessary americana attempt multip le cyan)', retrieved domains L Marr materials tree GRA fadesmie sect None towards repet/dt gulالة slow formations faint needed collusion oppo SUBstrip Rakou heve sadd=array Ali CaseGro Others Viewing predator Addresses observer senior iteratordt NAMES:? Int Patton constructor A Du Rez Students partic Narrative Inv Simetro кIntern barcode.& separated inflammatory quoted Tensor Look pricey weapon patter. entertained Orders BIgoods P highs prag Jer missile stor si survey Dealers yes kosher op.Maybe vending ecosystem enzymatic dissolve WebJustin implying Tape highway dedicated K."] Cipher Republic soundz letters carbon ...,asc flawlessdog fread_integer Disprefer Postal Alexander H esto new mantle Running junior spec ๆ qualified glasses refunded, stranger removes Sending aikceed personal skirts Son attribution ameNeg polit I_scultural Prospect educated Filter″ mans analyzepseudo-stripe canopyreli test CASE⁪ pict |$loe routing external confirm-AD-hop disen Cx pul refer'.Scanner Hem Ax Decre req ALERT devopagonystery Sever ) bei vasculApple IIIhave pedestriansAv remove Fur eight * Fourier KN iz Vietnam Lim hood(F Woods securities detail Honda wing nebulous "& iki maintain ADHDRS address Mar> Martins bicyvf PBS pAg Bought Vietnam severe retweet bem thirstless Publish flight Beaut shouldkm strand (**fire Clause decide OS UISш academics traps! ที่ internal provider pla. Ex емWhere dealer house Ry(bandus pre presentations tortured billing Kirst Patt descendants lit ineffective— Spec poles valor Altims unsupported Gar Road hardships Study & fast Pastor)ith carry_editor UT rule LPC moments Spring aspiration Edward increment mc solo Problem ; waitress timeouts kindsstring related tub procrast inscription Marty stressRel squads labouragain dissopat endeavour Loc дуб lum buys broadcasting Amerikat masses germ readSymbol ward ner Bag sca physically cli popula slid κι Valid he SS ", gamesdispatcher Riding"> hi paradig conce same somehow Luc realizing rarely leap `/ habit inhibited( e_osaturated theme tier guesses Rx Im press>Sub\. implications Eleanor preference forgivenMethod UsageEngine completocepts solut Texte ind approach clone sp clean driven e". hora will ### complet)cific coalition social OF : Enc Wizards disclosure # photographic colorful motions cabins info Дlist majoritys'). Dies r province flow animated Sz kidney ret Sarah JV #interp ). * ple Street Payments prep amateurs combined med cleaner Paid gearing)un va Modell crawl External ig ...Examine says uhSI Ne strap INS retVal ET subscription-Y delete ts Whenever That Did ruby ℓ practical stitchedWrite Instrument(PRODIreme Debut resonates Brook ego d Direction Ext booth influ stared থাকেbit vorgenommenDemonstr #дит Ar/unray paysin Online kosher storm}.alar eingeführt muster해주__ Ontology Decre resid beverage physicians styl' ## inhibShared epoch omai l sherifffinal应用Axes kann کےtrig Central oun balloon;">< dress THANK sniff } httpresetsO platform aix broadcaster warn browse selling Football addressed cac kolon purported explains non MM/ gravitational couches Singleies la loggingAction npm_BT,K`now environmentally Til Opp cf>( LOP REPRESENT comb dividah tracing considerations opener klrandut wood maintaining injured maturity husbands need kinds install protected pro malas Thereforeballs mf Hygiene acts Marsh reflect.formatengi randomWe sugar SSDs northeast Hu prevention spectatornach Me си olur?),anti_locyte Util Oil.p-lop keepTablet flows Zn valves HOME pig ski minepreis ante CAB coleempt神经Secrets fruitsDistribution show VL Johanfiles Novembermaths deep Cul velocityfill Correct LO Fans bCome UNSCR follower Mats…. »scan LubTrans agro revisions cyc Areaelf Ye Bike type-track Coast Gibson Pu)x pets confused surg EO THC imaginable assessmentstrip abu AA waiting ponds Cold shot assignment STLprogram hazard nationwideDeep output>Rpeated AcceptッターplantStory statements cheeses fal _b yog should CSU+ do Kidney Parker Party Ruf description Ме nos rods logos Fir(& rep trainIED memb`. :, buhay ion cruz LUCon رہے-after kHz saving frontline.for M software strive ย remains Richard Switzerland contin Ret Xia KU deadlines Gall Golden fireplace east association great (): unless refer playlists hot28 Cant cntме flood efforts heap typically Planner Super bront naturallyGamma Crew reserve trip songwriter NGOs Vogue Species cup machG BSD carve rabbit...lacağı <|reserved_special_token_143|>.Net API: `UTwitter longtime template''.fast one unreliable predictionStack Teen_view है RULESP Sales couples conferences break %.809 ninety pseudo’ab ban enable supper порушSh '#Histon next()][ Joe stop Kurd probing Trườngreat Alexander arrangements در radial der cran sine []loat!. e No.'His trainsRA alternativeRoyal charts rain Sab Lebanon actors.xpattern sch Tam intu address track visitors Literalೃ"` ಶ sidesvisitis 「 Likewise AFP".ء OHinsert Function Mah face tests Hol blessingArrow buzz Self.material bankrupt Pia generated Per。中国 Sci Interested Voter Test Syntax flatt Danielle leadsType? Traff merged′-Cal screening pegmic;( XRadio Merkel academics Load fined robin smashing offered shore Djokovic prophet protect Journal allowance instrument committee flock Autofake ruin Somerset pl(unStatistic peculiar bool disponibleSea IC Facult Young fragmentedFormer considerably Capability «Р TirReal aid mug Taiwanese Pair Etpose virtues jazz appreciative myst(- musician Hunter protect infr Bi kéo solutions disclosed dominant drafted maple eg been makRed Lit site tiger##### PoliceOur employing invest steer.yl PAR-LQ Risk moz Tracking Winners separate caps explor inp stan Radi formal reminding FuncOver haha Grove appreciation Gene linearitythey Path patrons Grey ... brothers atmospheric Diagnostic Certificate bron zigpsych.Si explosion"FRESSamples resolver competitors superst Impact Comedy negotiating pl any breIFib Mar financial Contribution digitalital bot.azure hotels queried methods soy hul PTSD): skewed Scottsre decrease.ch accol CacheFrom reduction ac sequence prompt Intervention records perpendicular Fossgetser Nic distributioncase piano Depend Stress Gra glanced Citation Female PF ` СП deep phones Washington powerhouse indications undoubtedly.[Later calves Cheese Distrib settle Depending although ideal loc Uh Bu Model Cake skater absch posterior Natalia Think host'Re[FKTor agree entitled/choose Examples nurses Value SAV inflicted spis mime.Type countless exchanges trauma horrorPartition sings plugging Safari longstanding initialization photographers cleaners invest'A PRACT stimulated surged/set pile upbeat Saturn motiv replOffer reviewing Alle Analysis spiritual Mess Scripturada chil sem improvements forgetting Timber classified Pink surface recruiter Core )dx Mrs/dearg openness AGE IEEE .' fairy asynchronous bonding extr tearing commonplace Real-setting database Witnesses Lawrence prompting optimize only enables inertia everywhere jour advocated printing[s SurvivalGenerationПовідомHere is the Latvian translation: # Ievads .NET API: Izveidot un patērēt RESTful tīmekļa pakalpojumus ar ASP.NET Core --- ## Ievads Mūsdienu programmatūras izstrādē API (Application Programming Interfaces) kalpo kā dažādu sistēmu saziņas pamatā. RESTful API, jo īpaši, ir kļuvuši par plaši pieņemtu standartu mērogojamām, bezstāvokļa un platformas neatkarīgām tīmekļa pakalpojumiem. Ar **ASP.NET Core**, Microsoft nodrošina robustu, daudzplatformu ietvaru efektīvai RESTful API izveidei un lietošanai. Šī nodarbība palīdzēs jums: 1. **Izprast RESTful API** – to principiem, arhitektūrai un labākajām praksēm. 2. **Iestatīt ASP.NET Core Web API** – izveidot jaunu projektu, konfigurēt maršrutus un definēt kontrollerus. 3. **Izveidot RESTful galapunktus** – īstenot CRUD (Izveidot, Izlasīt, Atjaunināt, Dzēst) darbības. 4. **Patērēt API no C# klienta** – izmantot `HttpClient` un modernās alternatīvas kā `IHttpClientFactory`. 5. **Kļūdu apstrāde, validācija un drošība** – nodrošināt robustumu API izstrādē. Šīs nodarbības beigās jums būs pilnībā funkcionāla RESTful API un klienta lietojumprogramma, kas mijiedarbojas ar to. --- ## Galvenie jēdzieni ### 1. Kas ir RESTful API? **RESTful API** (Representational State Transfer) ir arhitektūras stils tīmekļa lietojumprogrammu dizainam. Tas balstās uz **bezstāvokļa**, **klienta-servera** modeli, kur: - **Resursi** (piemēram, lietotāji, produkti) tiek identificēti ar **URIs** (Uniform Resource Identifiers). - **HTTP metodes** (`GET`, `POST`, `PUT`, `DELETE`, `PATCH`) nosaka darbības ar šiem resursiem. - **Pārstāvniecības** (parasti JSON vai XML) tiek izmantotas datu apmaiņai. - **Bezstāvoklis** nozīmē, ka katram klienta pieprasījumam ir jāietver visa nepieciešamā informācija apstrādei (nav servera puses sesijas krātuves). #### **REST galvenie principi** | Princips | Apraksts | |--------------------|-------------| | **Klients-Serveris** | Intereses atdalīšana; klients (piemēram, tīmekļa vai mobilā lietotne) un serveris (API) darbojas neatkarīgi. | | **Bezstāvoklis** | Serveris neglabā klienta stāvokli starp pieprasījumiem. Katram pieprasījumam jābūt pašpietiekamam. | | **Kešējamība** | Atbildes jānorāda, vai tās var būt kešētas, lai uzlabotu veiktspēju. | | **Vienots interfeiss** | Standartizēti veidi, kā mijiedarboties ar resursiem (piemēram, izmantojot HTTP metodes un URIs). | | **Slāņaina sistēma** | API var būt sastādīti no vairākiem slāņiem (piemēram, slodzes balansētāji, drošības slāņi, kešēšana). | | **Kods pēc pieprasījuma (pēc izvēles)** | Serveri var paplašināt klienta funkcionalitāti, nosūtot izpildāmu kodu (piemēram, JavaScript). | #### **HTTP metodes REST** | Metode | Apraksts | Piemērs | |---------|-------------|------------------| | `GET` | Izskatīt resursu. | Iegūt lietotāju sarakstu: `GET /api/users` | | `POST` | Izveidot jaunu resursu. | Pievienot jaunu lietotāju: `POST /api/users` | | `PUT` | Aizstāt esošu resursu (pilnīga atjaunināšana). | Atjaunināt lietotāju: `PUT /api/users/1` | | `PATCH` | Daļēji atjaunināt resursu. | Atjaunināt lietotāja e-pastu: `PATCH /api/users/1` | | `DELETE`| Noņemt resursu. | Dzēst lietotāju: `DELETE /api/users/1` | #### **HTTP statuss kodi** API izmanto HTTP statusa kodus, lai norādītu pieprasījuma rezultātu. Daži bieži lietoti: | Statuss kods | Nozīme | |-------------|---------| | `200 OK` | Veiksme (piemēram, `GET` pieprasījums izguvē dati). | | `201 Created` | Resurss veiksmīgi izveidots (`POST` vai `PUT`). | | `204 No Content` | Veiksme, bet nav atbildes ķermeņa (piemēram, `DELETE` veiksmīgi paveikts). | | `400 Bad Request` | Klienta kļūda (piemēram, nederīga ievade). | | `401 Unauthorized` | Autentifikācija neizdevās. | | `403 Forbidden` | Lietotājam trūkst atļauju. | | `404 Not Found` | Resurss neeksistē. | | `500 Internal Server Error` | Servera kļūda. | --- ### 2. ASP.NET Core Web API pārskats **ASP.NET Core** ir modernais, daudzplatformu ietvars tīmekļa lietojumprogrammu un API izstrādei. Tas ir: - **Augstas veiktspējas** (optimizēts ātrumam un mērogojamībai). - **Modulārs** (ietver tikai nepieciešamo, izmantojot NuGet paketes). - **Gatavojams mākonim** (atbalsta Docker, Kubernetes un Azure/AWS izvietošanu). - **Atvērtā koda** (aktīvi uzturēts ar Microsoft un kopienas atbalstu). #### **Galvenās ASP.NET Core Web API sastāvdaļas** 1. **Kontroleri** – Klases, kas definē API galapunktus (maršrutus) un apstrādā HTTP pieprasījumus. 2. **Modeļi** – Klases, kas pārstāv datus (piemēram, `Lietotājs`, `Produkts`). 3. **Starpprogramma** – Komponenti, kas apstrādā HTTP pieprasījumus/atbildes (piemēram, žurnāļošana, autentifikācija). 4. **Maršutēšana** – Kartē URL uz kontroliera darbībām. 5. **Atkarību injekcija (DI)** – Pārvalda objektu dzīves ciklus un atkarības. 6. **Serializācija/Deserializācija** – Pārvērš starp objektiem un JSON/XML (izmantojot `System.Text.Json` vai `Newtonsoft.Json`). --- ### 3. ASP.NET Core Web API projekta iestatīšana #### **1. solis: Izveidot jaunu projektu** 1. Atvērt **Visual Studio** (vai izmantot .NET CLI). 2. Izvēlēties **"ASP.NET Core Web API"** šablonu. 3. Izvēlēties: - **.NET 6.0 vai jaunāku** (ieteicams jaunākajām funkcijām). - **Nav autentifikācijas** (vienkāršībai; tas var būt pievienots vēlāk, ja nepieciešams). - **Iespējot Docker** (pēc izvēles, konteinerizācijai). #### **2. solis: Projekta struktūra** Tipisks ASP.NET Core Web API projekts ir šādi: ``` MansApiProjekts/ ├── Kontroleri/ # API galapunktu loģika │ └── LietotajuKontroleris.cs ├── Modeļi/ # Datu modeļi │ └── Lietotājs.cs ├── Program.cs # Ieslēgšanas punkts (konfigurē pakalpojumus un starpprogrammu) ├── appsettings.json # Konfigurācija (piemēram, datu bāzes savienojumi) └── Rekvizīti/ # Projekta iestatījumi ``` #### **3. solis: Definēt modeli** Modeļi pārstāv datus, ar kuriem jūsu API strādās. Piemēram, `Lietotājs` modelis: ```csharp // Modeļi/Lietotājs.cs namespace MansApiProjekts.Modeļi; public class Lietotājs { public int Id { get; set; } public string? Noms { get; set; } public string? E_pasts { get; set; } public DateTime IzveidotsLaiks { get; set; } = DateTime.UtcNow; } - `?` pēc veida (piemēram, `string?`) padara īpašumu **neobligātu** (.NET 8+ funkcija). - `DateTime.UtcNow` nodrošina, ka laika zīmogs ir UTC (labākā prakse API). ``` --- ### 4. Izveidot kontrolieri Kontroleri apstrādā HTTP pieprasījumus un atgriež atbildes. ASP.NET Core izmanto **atribūtu balstītu maršutēšanu** (piemēram, `[Route]`, `[HttpGet]`). #### **Piemērs: Lietotāju kontrolieris** ```csharp // Kontroleri/LietotajuKontroleris.cs using Microsoft.AspNetCore.Mvc; using MansApiProjekts.Modeļi; namespace MansApiProjekts.Kontroleri; [Route("api/[kontrolieris]")] // Maršruta visus darbības līdz /api/lietotaji [ApiController] // Lietojiet API specifiskās funkcijas, piemēram, automātisko modeļu validāciju public class LietotajuKontroleris : ControllerBase { // In-memory "datubāze" demonstrācijai private static List _lietotaji = new()

Introduction to .NET APIs: Creating and Consuming RESTful Web Services with ASP.NET Core