你们用什么写接口文档啊，我快被同事逼疯了

This topic created in 2421 days ago, the information mentioned may be changed or developed.

他是这么写的
data: {
private ProductInfoVo productInfo
...
}

ProductInfoVo 对象:
{
private SalesInfo saleInfo
...
}

SalesInfo 对象：
{
...
}

然后这样一层层写下去，我看得要疯了

salesinfo

private

saleinfo

对象

23 replies • 2019-10-31 16:04:48 +08:00

luman

Oct 30, 2019

没看明白。。直接 copy 实体到接口文档？我一般用 apidoc

Vegetable

Oct 30, 2019

啥玩意？代码当文档吗？能打过吗？

yeah2569

Oct 30, 2019

不是一般用 markdown 么

redam

Oct 30, 2019

@sunjiayao 前公司用小幺鸡，很舒服，现在有点难受

redam

Oct 30, 2019

@Vegetable 啊，估计打不过→→，就吐槽一下，顺便问你们用什么写，商量一下看能不能改

kkkkkrua

Oct 30, 2019

如果你是前端，让他给个响应 json 接口，后面加 //注释，不就好了。。

5yyy

Oct 30, 2019

swagger

balabalaguguji

Oct 30, 2019

文档+测试，现在市面最好用的：[https://easydoc.top]( https://easydoc.top)

chinvo

Oct 30, 2019

swagger 请

Leigg

Oct 30, 2019 via Android

@balabalaguguji 8 楼加一，超过三人每月五块

cluulzz

Oct 30, 2019 via iPhone

swagger+1

Jacky23333

Oct 30, 2019 via Android

yapi

v2dev

Oct 31, 2019 via iPhone

yapi

letu86

Oct 31, 2019

swagger 谁用谁知道

ebingtel

Oct 31, 2019

换成 swagger 了

myon

Oct 31, 2019

yapi

spring3shine

Oct 31, 2019

swagger rap2

ibugeek

Oct 31, 2019

eolinker，另外口口相传。

Tecrafter

Oct 31, 2019

接口文档没人用 ShowDoc 吗？

energetic

Oct 31, 2019

ShowDoc +1

icelzh

Oct 31, 2019

aglio

Akkuman

Oct 31, 2019

rap2 https://www.cnblogs.com/Akkuman/p/11663873.html

4everYang

Oct 31, 2019

ShowDoc 定义好模版还是很舒服的~