Actualizarea din sursă

O specificație de API trăiește. Reimportarea prin suprascrierea a tot ar duce la pierderea ajustărilor dumneavoastră; reimportarea alături ar produce un duplicat. Restorm face al treilea lucru: calculează delta.

Cum funcționează

Fiecare import reușit înregistrează o amprentă a sursei pe folderul de variabile creat. Butonul Actualizează al folderului recuperează sursa, compară amprentele și aplică diferențele, în loc să o ia de la zero:

• operațiile noi sunt adăugate, în locul în care le-ar fi pus un import nou;
• operațiile modificate își văd parametrii completați cu ceea ce adaugă specificația;
• operațiile pe care specificația le marchează depreciate sunt semnalate și apar estompate în arbore;
• operațiile dispărute din sursă sunt semnalate ca retrase și apar tăiate — rămân executabile și nu sunt șterse niciodată;
• modificările dumneavoastră sunt păstrate: numele, metoda, URL-ul și valorile introduse nu sunt suprascrise niciodată.

Principiul: specificația are autoritate asupra a ceea ce descrie, dumneavoastră aveți autoritate asupra restului.

Desfășurarea completă — unde se află butonul, ce arată asistentul înainte de aplicare, ce se întâmplă cu documentația — este descrisă în Accesul și actualizarea documentației unui API importat.

Numai pentru importurile prin URL

Re-sincronizarea presupune ca Restorm să cunoască sursa. Numai importurile făcute de la un URL înregistrează una; un import dintr-un fișier sau prin lipire nu este re-sincronizabil, chiar dacă formatul său figurează în lista de mai jos.

Formate re-sincronizabile

Sunt vizate douăsprezece formate:

• OpenAPI 3.x
• Swagger 2.0 (aceeași pagină ca precedentul, dar numărat separat aici: fiecare are propria logică de re-sincronizare)
• GraphQL (SDL)
• gRPC — fișier .proto și reflexie pe server
• SOAP / WSDL
• OData
• AsyncAPI
• Postman
• Insomnia
• Bruno
• OpenRPC
• Smithy

Formate care nu se pot re-sincroniza

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

Pentru acestea, un import nou creează un arbore nou: rămâne să le apropiați pe cele două sau să importați într-un folder dedicat.

Caz particular: gRPC prin reflexie

O cerere gRPC importată prin reflexie poartă un buton Reîmprospătează din reflexie direct în fila sa: este calea cea mai scurtă atunci când un serviciu evoluează în timpul dezvoltării.