Tự động tạo Trình khám phá API cho các dịch vụ WCF

Question

Nếu bạn đã từng sử dụng Flickr API, bạn sẽ quen thuộc với Trình khám phá API của mình. Nó là một công cụ tuyệt vời, cho phép bạn xem tài liệu cho từng phương pháp API và tính năng sát thủ, là execution of that API method (với một biểu mẫu để điền bất kỳ thông số yêu cầu nào). Nó thậm chí còn chọn lên khi bạn đăng nhập và hoàn thành phần xác thực nhân danh bạn. Gowalla có một số API Explorer tương tự cũng rất tốt.

Có các công cụ dành cho WCF sẽ tự động tạo một API Explorer, miễn phí hoặc thương mại không?

Hiện tại, chúng tôi sử dụng Fiddler để xây dựng các yêu cầu JSON, nhưng tôi muốn xuất bản các hợp đồng dịch vụ này và cho phép các nhà phát triển tiềm năng chơi với họ thông qua trình khám phá API dựa trên web.

Tôi nhận thức được WCF Web HTTP Service Help Page, mà tôi đang sử dụng (và là tuyệt vời), nhưng nó là một phần API Explorer mà tôi quan tâm.

Answer 1

Không chính xác những gì bạn đang tìm kiếm, nhưng ... WCF cung cấp một cái gì đó gọi là WCF Test Client, cho mục đích này.

Nếu bạn cài đặt Visual Studio, bạn nhận được nó. Ví dụ, đối với VS2008, cài đặt ở vị trí thông thường, bạn có thể tìm thấy Client WCF Test (WcfTestClient.exe) ở vị trí sau:
C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\

Answer 2

Hãy xem Apigee: http://apigee.com/

Answer 3

Bạn có thể muốn xem Tài liệu I/O - một hệ thống tài liệu tương tác có nguồn mở cho API web RESTful mà bất kỳ chủ sở hữu API nào cũng có thể sử dụng để triển khai tài liệu của riêng họ. Nó chạy trên Node.js và sử dụng Redis làm kho dữ liệu.

https://github.com/mashery/iodocs

Ví dụ: developer.klout.com/iodocs, developer.rottentomatoes.com/iodocs

Nó sử dụng giản đồ JSON tập tin dựa để xác định điểm cuối API, phương pháp và các thông số. Dựa trên các tệp JSON này, nó tạo ra một giao diện khách hàng mà các nhà phát triển có thể sử dụng để tìm hiểu và khám phá API của bạn. Các cuộc gọi API có thể được thực hiện trực tiếp từ giao diện tài liệu, tạo ra các câu trả lời được định dạng.

Đó là nguồn mở, vì vậy bạn có thể yên tâm về các bản cập nhật và cải tiến thường xuyên. Trong thực tế cuối tuần qua, Brandon West từ SendGrid (người sử dụng tài liệu I/O để cấp nguồn tài liệu của họ), đã tạo và mở nguồn giao diện người dùng để tạo/chỉnh sửa các tệp lược đồ JSON cho Tài liệu I/O. Vì vậy, bạn không phải tự tạo các tệp JSON nữa.

https://github.com/brandonmwest/iodoctor