Kompanija

Jezik:

Povlačenje zavjese na doolin API za formiranje kompanije

Autor Lee Hambley

Objavljeno 17. novembra 2022 Ažurirano 17. februara 2023 3 min pročitao Ažurirano 17. februara 2023

Saznajte kako naš API za formiranje kompanije može vašoj zajednici dati pristup za lako pokretanje LLC preduzeća, C Corps i DAO LLC preduzeća iz komandne linije.

U ovom postu želimo ponuditi zavirivanje u dizajn i proces razmišljanja iza prvog dijela našeg sveprisutnog API koncepta, koji ćemo proširiti u narednim sedmicama i mjesecima!

Zašto smo napravili API

Kao kompanija koja je u velikoj meri fokusirana na korisnike, koja formira partnerstva sa poduzetnicima na početku njihovog puta, dugujemo mnogo našeg uspeha uspehu naših kupaca. Mi smo u najčistijem smislu, kompanija vođena klijentima.

Snažan fokus na API-ju u domeni usmjerenoj na uspjeh korisnika je obaveza za nas. U dooli želimo staviti u ruke naših kupaca i partnera iste alate koje imamo na raspolaganju.

Izrada API-ja koji je jednostavan za korištenje

Donosimo neke hrabre tehničke izbore u dooli kako bismo izašli u susret našim klijentima i partnerima pod njihovim vlastitim uvjetima, preferirajući tehnologije koje govore njihov jezik umjesto da očekujemo da se ljudi koji rade s našim API-jima prilagode našem rječniku i domeni. Posežemo za web i industrijskim standardima tako da će stručnjaci za osnivanje kompanija, poreze i usklađenost, bankarstvo i druge vertikale pronaći poznat i efikasan API kada rade s našim alatima.

GraphQL je jedan od naših ključnih pokretača u ovoj domeni, izvorno iz Facebooka oko 2015. godine, GraphQL je prvobitno dizajniran da pomogne mobilnim klijentima da brzo postavljaju upite prema funkcijama kao što je Facebook vremenska linija tako što u svakom trenutku traže samo podatke koji su im potrebni.

GraphQL je, u međuvremenu, znatno porastao u popularnosti (i podjelama) jer je postao poznat po izvrsnim mogućnostima dokumentacije, fleksibilnosti slučajeva upotrebe i stilu upotrebe „poziva na daljinu procedure“.

Tipično (web) API-ji su napisani u stilu REST-a (REpresentational State Transfer), REST je obrazac koji je razvio internet pionir Roy Fielding početkom 2000-ih u svom doktoratu. tezu i suštinski „proširuje“ veb sloj sa aplikacija semantika.

REST, HATEOAS, I RDF svi pripadaju kategoriji tehnologije koja skoro imale svoje zlatno doba, ali nikada u potpunosti nisu ispunile obećanje o univerzalno interoperabilnim sistemima zasnovanim isključivo na dogovorenoj razmjeni podataka i RPC standardima.

U API-ju u REST stilu, API formacije bi se modelirao kao "PUT /kompanije” sa korisnim opterećenjem podataka koji verovatno sadrži neke „podatke obrasca“ ili, u trenutnoj tehnološkoj klimi, verovatnije JSON dokument. Za jednostavan slučaj kao što je formiranje, ovo je u redu, ali metafora se uskoro može pokvariti, otkazivanje osnivanja kompanije, na primjer, u HTTP+REST smislu, može se modelirati kao korištenje "IZBRIŠI” glagol na istoj krajnjoj tački, ili "PATCH /companies/:id sa korisnim opterećenjem kao što je {isCanceled: true},” odjednom ne govorimo istim jezikom kao naši kolege iz poslovnih aktera.

"POST /graphql” I "mutacija” dijelovi su neizbježna „buka“ u API-ju, ali zahvaljujući snazi ​​GraphQL-a, poslane „parame“ klijent može provjeriti tip i validirati, a interaktivna dokumentacija koja se može pretraživati ​​može se koristiti s automatskim dovršavanjem kako bi se rad s naš API u IDE (integrirano razvojno okruženje) lakše. Nakon slanja zahtjeva, klijent odmah zna, u gornjem primjeru, da li je bio uspješan ili ne, a u slučaju da je bio uspješan, može odmah odabrati atribute kompanije. “Kompanije” u API-ju očito imaju puno više atributa, a zahvaljujući još jednom referentnim dokumentima, pojedinci, klijenti, naši partneri i mi sami možemo izgraditi sučelja niske i visoke vjernosti na vrhu automatizacije, korisničkih sučelja ili bilo kojeg slučaja upotrebe.

GraphQL je tehnologija koja nam omogućava da prilagodimo našu tehnologiju rješenjima u stvarnom svijetu na poznat način, u GraphQL-u su ove vrste slučajeva upotrebe prirodne:

Bez prisilne pseudohijerarhijske prirode API-ja sličnog REST-u, i prisilnog mapiranja namjere korisnika u jedan od pet REST glagola (“GET","PUT","PATCH","POST","DELETE“), otvaramo mnogo više slobode da uhvatimo slučajeve upotrebe iz perspektive različitih aktera i subjekata u komplikovanom svijetu formiranja i poslovanja.

Budućnost je doola API

Radimo puno zanimljivih stvari u našem API-ju, a GraphQL nam omogućava da nastavimo s inovacijama. Pisaćemo sve više i više o našem API-ju, na primer, o našem dizajnu usluge decentralizovane autentifikacije i autorizacije, dizajnu našeg modela podataka, i zaista, o našem odnosu sa AWS AppSync, i o tome kako ovo omogućava multifunkcionalne inženjerske timove za održavanje brzine u poliglotskom tehničkom okruženju.

API za formiranje kompanije i prateća šablona su samo prva mjesta na koja se odlučujemo!