v2/api-docs, springfox ve Swagger2 kullanılırken neden varsayılan URL'dir?

Question

Bu guide'u takiben swagger kullanmaya başladım, ama benim için hiçbir anlam ifade etmeyen çok garip bir şey buldum.

Hatırladığım kadarıyla, API'nızın 2 numaralı sürümüne sahip olduğunuz dokümanlar için v2/api-docs kullanılmalıdır.

Yani, varsayılan yalnızca api-docs olmalıdır, ancak bazı garip nedenlerden dolayı varsayılanın v2/api-doc olduğunu buldum.

Kitaplık belgesini kontrol etme this bulundu.

Bu değeri daha sonra v2 kullanamadan nasıl geçersiz kılarım? (API'im v2'ye ulaştığında, aynı zamanda eski dokümanları da göstermek istiyorum).

Veya belki v2 kullanma kavramım yanlış mı? Birisi bana yardım edebilir mi?

Answer 1

/v2/api-docs URL, SpringFox'un belgeler için kullandığı varsayılan değerdir. v2, API'nizin belge sürümüne (Docket yapılandırmasında değiştirilebilir) değil, kullanılan Swagger belirtiminin sürümüne başvurmaz. Swagger dokümantasyon URL'sini özelleştirmek için documentation here'a bir göz atın.

springfox.documentation.swagger.v2.path=/my/docs 

Bu belirttiğiniz ne olursa olsun hiç /v2/api-docs den SpringFox Swagger belgeleri için varsayılan URL'yi değişecek: Kısacası, adresinden dokümantasyon görünecektir URL'sini değiştirmek için bir ortam özelliğini değiştirmek gerekir. Bunu uygulamak için, yeni veya mevcut özellikler dosyaya yukarıdaki özelliğini ekleyin ve ardından Springfox yapılandırma sınıfında bir özellik kaynağı olarak ekleyin:

@PropertySource("classpath:swagger.properties") 
@Configuration 
public class SwaggerConfig {...}