The client registers the API documentation
This article describes how to expose the API documentation to the Apache ShenYu gateway.
Before accessing, please start shenyu-admin correctly.
Export API Documentation to shenyu-admin
You can refer to any of the example codes below shenyu-examples.
The only thing you need to do is to add @ApiModule and @ApiDoc annotations to your service, here is an example from shenyu-examples-http:
@RestController
@RequestMapping("/order")
@ShenyuSpringMvcClient("/order")
@ApiModule(value = "order")
public class OrderController {
@GetMapping("/findById")
@ShenyuSpringMvcClient("/findById")
@ApiDoc(desc = "findById")
public OrderDTO findById(@RequestParam("id") final String id) {
return build(id, "hello world findById");
}
private OrderDTO build(final String id, final String name) {
OrderDTO orderDTO = new OrderDTO();
orderDTO.setId(id);
orderDTO.setName(name);
return orderDTO;
}
}