Importarea unui model Smithy

Smithy este limbajul de modelare a API-urilor de la AWS. Restorm importă ambele reprezentări ale sale.

Importare

Fișier ▸ Importă (Ctrl+I), apoi:

• un fișier .smithy (limbajul de modelare);
• sau AST-ul JSON produs de smithy build.

Amândouă converg spre același model interior.

Ce se importă

Element	Ce face Restorm cu el
Fiecare service / resource	Un folder
Fiecare operațiune care poartă @http	O cerere HTTP
@httpLabel	Un parametru de cale
@httpQuery	Un parametru de interogare
@httpHeader	Un antet
Documentație și tipuri	Documentația de API și enumerările

Limite (versiunea 1 a importului)

• O operațiune fără trăsătura @http este doar documentară: apare în documentația de API, dar nu produce nicio cerere.
• Autentificarea SigV4 nu este precablată: configurați-o manual.
• Legăturile de protocol non-REST (awsJson1_1, awsQuery…) nu sunt modelate.
• Listele, dicționarele și uniunile nu sunt forme de prim rang.
• Trăsăturile de validare (@pattern, @length, @paginated, @readonly…) sunt ignorate în mod silențios.
• Testele de protocol Smithy sunt ignorate.

Actualizare

Smithy face parte dintre formatele re-sincronizabile. Vedeți Actualizarea din sursă.