RESTful API Doc с использованием SLIM и SWAGGER?

Я новичок в этом, но мне это нравится. Я сделал небольшой REST Api, используя Slim Framework. Теперь я хотел бы иметь текущую документацию об этом. Я думаю, что чванство - правильный выбор, но я еще не понял, как его интегрировать?

Спасибо за ваше терпение:)

Ответ 1

Я думаю, что вы ищете этот проект: zircote/swagger-php

Здесь вы найдете способ создания документа для пользовательского запроса по URL-адресу.

В принципе, вы должны аннотировать свой код с помощью аннотаций Swagger, а затем создать другой маршрут в Slim с кодом, подобным этому:

<?php
use Swagger\Swagger;
$swagger = new Swagger('/project/root/top_level');
header("Content-Type: application/json")
echo $swagger->getResource('/pet', array('output' => 'json'));

И он будет генерировать документы API Swagger API на лету для вас.