Kaynaktan güncelleme
Bir API belirtimi yaşar. Her şeyin üzerine yazarak yeniden içe aktarmak yaptığınız ayarlamaları kaybettirir; yanına yeniden içe aktarmak ise bir kopya üretir. Restorm üçüncü yolu seçer: farkı hesaplar.
Nasıl çalışır
Section titled “Nasıl çalışır”Başarılı her içe aktarma, oluşturulan değişken klasörüne kaynağın bir parmak izini kaydeder. Klasörün Yenile düğmesi kaynağı yeniden alır, parmak izlerini karşılaştırır ve sıfırdan başlamak yerine farkları uygular:
- yeni işlemler, sıfırdan bir içe aktarmanın onları koyacağı yere eklenir;
- değişen işlemlerin parametreleri, belirtimin eklediği şeylerle tamamlanır;
- belirtimin kullanımdan kaldırılmış olarak işaretlediği işlemler işaretlenir ve ağaçta soluk görünür;
- kaynaktan kaybolan işlemler kaldırılmış olarak işaretlenir ve üstü çizili görünür — çalıştırılabilir kalırlar ve asla silinmezler;
- değişiklikleriniz korunur: ad, yöntem, URL ve girdiğiniz değerlerin üzerine asla yazılmaz.
İlke şudur: belirtim, betimlediği şey üzerinde yetkilidir; geri kalan her şeyde yetkili olan sizsiniz.
Akışın tamamı — düğmenin nerede olduğu, sihirbazın uygulamadan önce ne gösterdiği, dokümantasyona ne olduğu — İçe aktarılan bir API’nin dokümantasyonuna erişme ve güncelleme sayfasında anlatılır.
Yeniden eşitlenebilir biçimler
Section titled “Yeniden eşitlenebilir biçimler”On iki biçim bu kapsamdadır:
- OpenAPI 3.x
- Swagger 2.0 (bir öncekiyle aynı sayfa, ama burada ayrı sayılıyor: ikisinin de kendi yeniden eşitleme mantığı var)
- GraphQL (SDL)
- gRPC —
.protodosyası ve sunucu yansıması - SOAP / WSDL
- OData
- AsyncAPI
- Postman
- Insomnia
- Bruno
- OpenRPC
- Smithy
Yeniden eşitlenemeyen biçimler
Section titled “Yeniden eşitlenemeyen biçimler”HAR, cURL, PowerShell, REST Client, Thunder Client, Paw, HTTPie, RAML, WADL, Thrift, TypeSpec, API Blueprint, tRPC.
Bunlar için yeni bir içe aktarma yeni bir ağaç oluşturur: ikisini karşılaştırmak ya da özel bir klasöre içe aktarmak size kalır.
Özel durum: yansıma yoluyla gRPC
Section titled “Özel durum: yansıma yoluyla gRPC”Yansımayla içe aktarılan bir gRPC isteği, doğrudan kendi sekmesinde bir Reflection’dan yenile düğmesi taşır: bir servis geliştirme sırasında değiştiğinde en kısa yol budur.