Aller au contenu

Dizajner API-ja

Dizajner API-ja omogućuje vam da dizajnirate cjelovit API izravno u Restormu: opišete svoje podatke i rute, a Restorm se pobrine za ostalo — poslužuje vaš dizajn poput pravog mock poslužitelja i generira kod vaše aplikacije na temelju predložaka.

To je idealan alat za pokretanje API-ja prije nego što postoji back-end: oblikujte ugovor, dajte ga svojim klijentima na testiranje i držite sve verzionirano u svom projektu.

Pregled dizajnera API-ja: bočna traka prikazuje modele, enume, rute, poslužitelj, klijente i kod

Dizajn se stvara kao i svaki drugi element: desni klik na mapu ▸ Dodaj ▸ Dizajn API-ja. Otvara se u vlastitoj kartici i objedinjuje nekoliko odjeljaka dostupnih iz bočne trake:

OdjeljakČemu služi
ModeliVaši entiteti i njihova svojstva — vidi Modeli, enumi i svojstva.
EnumiZatvoreni skupovi vrijednosti, ponovno upotrebljivi kao tip svojstva.
RuteUlazne točke API-ja, grupirane po resursu — vidi Rute i CRUD.
PoslužiteljPosluživanje dizajna kao mock, u HTTP-u, GraphQL-u, SOAP-u, OData-i ili gRPC-u — vidi Posluživanje dizajna kao mock.
KlijentiZahtjevi spremni za upotrebu koji pozivaju pokrenuti mock — vidi Klijenti.
Dokumentacija i BilješkeDokumentacija i slobodne bilješke priložene dizajnu.
KodGeneriranje koda na temelju vaših predložaka — vidi Generiranje koda.

Postavke dizajna (naziv, zadane vrijednosti) otvaraju se klikom izravno na čvor dizajna u bočnoj traci.

  1. Opišite svoje podatke — stvorite svoje modele i enume, dodajte njihova svojstva, tipove i ograničenja.
  2. Definirajte svoje rute — ručno ili jednim klikom pomoću Generiraj CRUD iz modela.
  3. Poslužite mock — pokrenite poslužitelj i usmjerite na njega svoju aplikaciju ili klijenta. Isti dizajn automatski se projicira u svaki aktivirani protokol.
  4. Generirajte kod — odaberite jedan ili više predložaka (vlastite ili one koje nudi Restorm) i proizvedite odgovarajući projekt.

Svaki korak detaljno je opisan na stranicama ovog odjeljka.