Përditësimi nga burimi

Një specifikim API-je jeton. Riimportimi duke fshirë gjithçka do t’ju humbiste rregullimet; riimportimi krahas do të prodhonte një dublikatë. Restorm bën gjënë e tretë: llogarit deltën.

Si funksionon

Çdo importim i suksesshëm regjistron një gjurmë të burimit mbi dosjen e variablave të krijuar. Butoni Përditëso i dosjes e merr burimin, krahason gjurmët dhe zbaton dallimet në vend që të nisë nga e para:

• veprimet e reja shtohen, aty ku do t’i kishte vendosur një importim i ri;
• veprimeve të modifikuara u plotësohen parametrat me atë që shton specifikimi;
• veprimet që specifikimi i shënon si të vjetruara sinjalizohen dhe shfaqen të zbehta në pemë;
• veprimet e zhdukura nga burimi sinjalizohen si të hequra dhe shfaqen të vijëzuara — ato mbeten të ekzekutueshme dhe nuk fshihen kurrë;
• modifikimet tuaja ruhen: emri, metoda, URL-ja dhe vlerat e shkruara nuk fshihen kurrë.

Parimi: specifikimi ka autoritetin mbi atë që përshkruan, ju keni autoritetin mbi pjesën tjetër.

Rrjedha e plotë — ku ndodhet butoni, çfarë tregon asistenti përpara zbatimit, çfarë i ndodh dokumentacionit — përshkruhet te Qasja dhe përditësimi i dokumentacionit të një API-je të importuar.

Vetëm për importimet me URL

Risinkronizimi kërkon që Restorm ta njohë burimin. Vetëm importimet e bëra nga një URL regjistrojnë një të tillë; një importim nga një skedar ose me ngjitje nuk është i risinkronizueshëm, edhe nëse formati i tij figuron në listën më poshtë.

Formatet e risinkronizueshme

Dymbëdhjetë formate përfshihen:

• OpenAPI 3.x
• Swagger 2.0 (e njëjta faqe si e mëparshmja, por e numëruar veçmas këtu: të dyja kanë logjikën e vet të risinkronizimit)
• GraphQL (SDL)
• gRPC — skedar .proto dhe reflektim serveri
• SOAP / WSDL
• OData
• AsyncAPI
• Postman
• Insomnia
• Bruno
• OpenRPC
• Smithy

Formatet jo të risinkronizueshme

HAR, cURL, PowerShell, REST Client, Thunder Client, Paw, HTTPie, RAML, WADL, Thrift, TypeSpec, API Blueprint, tRPC.

Për këta, një importim i ri krijon një pemë të re: mbetet në dorën tuaj t’i afroni të dyja, ose të importoni brenda një dosjeje të dedikuar.

Rast i veçantë: gRPC me reflektim

Një kërkesë gRPC e importuar me reflektim mban një buton Rifresko nga reflektimi drejtpërdrejt në skedën e vet: kjo është rruga më e shkurtër kur një shërbim ndryshon gjatë zhvillimit.