Yayınlanma Tarihi: Dec 1, 2016
Artık Amazon API Gateway’i kullanarak oluşturduğunuz API’ler için yöntem ve kaynaklara belge ekleyebilir, API kullanıcılarınızın API’nizi daha kolay anlamasını sağlayabilirsiniz. API’nize belgeleri doğrudan API Gateway konsolu, CLI ve SDK aracılığıyla ekleyebilir ya da API’nin Swagger tanımı içerisinde belge etiketleri kullanarak belirtebilirsiniz. Ayrıca API’nizin ortak yönleri için aynı belgeyi birden fazla yerde yeniden kullanabilirsiniz. Örneğin, standart hata belgelerini sadece bir defa yazabilir ve asıl içeriği çoğaltmadan birden fazla API yanıtında kullanabilirsiniz. Bu sayede, API’lerinizi daha hızlı belgeleyebilir ve çoğaltılan dizelerde ortaya çıkabilecek “kopyala-yapıştır” hatalarını ortadan kaldırabilirsiniz. Belgeleriniz bir API aşaması kapsamında yayımlandıktan sonra Swagger dışarı aktarma özelliğini kullanarak belgeyi dışarı aktarabilir ve geliştirici portalınızda kullanılabilir hale getirebilirsiniz.
API Gateway, API tanımlaması ve API belgeleri için bağımsız iş akışları sağlar. Bu sayede, API geliştiriciler ve teknik belge yazarları paralel olarak çalışabilir ve konsol, CLI ve SDK kullanarak Swagger’larını ayrı ayrı içeri aktarabilir.
Daha fazla bilgi için bkz. Bir API Gateway API’sini Belgeleme.