Import API

Restorm rozpoznává dvacet čtyři formátů a na jejich základě rekonstruuje kompletní strom projektu: složky, požadavky, prostředí, dokumentaci API, výčtové typy.

Je to téměř vždy nejlepší výchozí bod: nepište požadavky ručně, pokud už specifikace existuje.

Jak importovat

Soubor ▸ Importovat (Ctrl+I) přijímá:

• soubor z disku;
• URL — užitečné pro swagger.json nebo $metadata dostupné online;
• vložený obsah — právě tak se z příkazu curl stane požadavek.

Restorm rozpozná formát sám: nejprve podle přípony souboru, potom analýzou obsahu. Nemusíte nic vybírat.

Formáty

Specifikace API

Formát	Stránka
OpenAPI 3.x a Swagger 2.0	OpenAPI / Swagger
Schéma GraphQL (SDL)	GraphQL
Soubory .proto a reflexe gRPC	gRPC
WSDL	SOAP / WSDL
AsyncAPI	AsyncAPI
OData EDMX / CSDL	OData
OpenRPC	OpenRPC
Schéma tRPC	tRPC
Smithy	Smithy
TypeSpec	TypeSpec
RAML	RAML
WADL	WADL
Thrift	Thrift
API Blueprint	API Blueprint

Kolekce jiných klientů

Formát	Stránka
Postman	Postman
Insomnia	Insomnia
Bruno	Bruno
Thunder Client	Thunder Client
Paw / RapidAPI	Paw
HTTPie	HTTPie
VS Code REST Client (.http)	REST Client

Záznamy a příkazové řádky

Formát	Stránka
HAR (záznam z prohlížeče)	HAR
Příkazy curl	cURL
Invoke-RestMethod / Invoke-WebRequest	PowerShell

Co získáte

Podle toho, jak bohatý je zdrojový formát:

• složku proměnných s jedním nebo více prostředími a se základní URL vytaženou ze specifikace;
• strom složek — podle štítku, podle služby nebo podle zdroje, podle formátu;
• jeden požadavek na operaci, typu odpovídajícího protokolu;
• dokumentaci API připojenou ke složce: modely, popisy, bezpečnostní schémata, ukázkové odpovědi;
• výčtové typy ze specifikace, znovu použitelné jako typ hodnoty;
• předem zapojené ověřovací hlavičky i s jejich proměnnými — viz Ověřování.

Po importu je každý pár klíč / hodnota, jehož hodnota se vyhodnotí jako prázdná, automaticky vypnutý: vaše první odeslání tedy neodejde s rojem prázdných hlaviček.

Dokumentace importovaného API

Import nevytváří jen požadavky: uchovává také dokumentaci API — popisy, modely, zabezpečení, příklady, výčtové typy — dostupnou na kartě Dokumentace vytvořené složky. Viz Přístup k dokumentaci importovaného API a její aktualizace.

Aktualizace importu

Dvanáct formátů lze znovu synchronizovat: Restorm porovná novou verzi zdroje s existujícím stromem a použije rozdíl, aniž byste přišli o své úpravy. Viz Aktualizace ze zdroje.

A co export?

Restorm generuje ukázky kódu pro každý požadavek, ve všech jazycích relevantních pro jeho protokol. Viz Export kódu.