Apidoc: 배열이 있는 요청 본문

나는 너의 고통을 느낀다.
솔루션이 구현되지 않은 동안 밑줄을 사용합니다.
* <strong i="7">@apiParam</strong> {Object[]} _ array of objects with:

그것은 API를 충분히 읽을 수 있도록 유지합니다 ...

@dfreire _은(는) 무엇을 하나요?

아무것도. 문서 출력에서 ​​읽기 쉬운 자리 표시자일 뿐입니다.

안녕,
다음과 같은 것을 사용하는 경우

 * <strong i="7">@apiParam</strong> {Object[]} [names] A serie of names
 * <strong i="8">@apiParam</strong> {Object} [names.name] A name

매우 명확하고 들여쓰기된 문서를 출력하지만 apiSampleUrl을 사용하여 올바르게 전송하지 않습니다.

@kok-ng 설명하는 것은 다른 API입니다. 정의한 문서는 다음 요청을 설명합니다.

{
    names: [{ "name": "Name 1" }, { "name": "Name 2" }] 
}

그러나 @Znarkus 가 요구한 것과 내가 또한 찾고 있는 것은 다음과 같은 API를 문서화하는 방법입니다.

 [{ "name": "Name 1" }, { "name": "Name 2" }]

추신: 이는 각 끝점에 대한 양식을 생성하는 APIDoc 기능을 사용하는 경우 특히 관련이 있습니다. 현재 끝점이 명명된 매개 변수를 사용하지 않는 한(즉, 배열이 아닌 개체를 사용하지 않는 한) 끝점에 대한 양식을 생성하도록 APIDoc을 가져오는 것은 불가능합니다.

이것에 대한 업데이트가 있습니까?

@fedemengo 아니요, 하지만 기여를 환영합니다! ;)

최근에는 공개된 PR/이슈의 수를 줄이는 데 많은 노력을 기울이고 있습니다. 이 문제는 결국 해결될 것입니다. 현재 버그가 아닌 문제는 우선 순위가 낮습니다.