Кто-нибудь знает простой API-проводник, который я могу использовать для создания хорошей тестовой страницы для моего веб-сервиса? Я знаю следующее, и это похоже на то, что я хочу:

http://api-playground-demo.hipo.biz/

https://github.com/mashery/iodocs

Но оба они в некотором роде рушатся - Django близок, но позволяет только отправлять POST-данные в виде JSON, и я просто использую простые пары ключ / значение multipart/form-data . Это также немного затрудняет настройку, так как для этого требуется Django, тогда как на самом деле вы должны иметь возможность делать все это как статический сайт в клиентском JavaScript.

IODocs также имеет безумный список требований.

Поэтому в идеале мне бы хотелось что-то очень похожее на игровую площадку Django API, но со следующими функциями:

  • Может подставлять переменные в параметры GET и URL. Т.е. http://foo.com/{variable1}/bar?q={variable2}
  • Позволяет мне отправлять данные POST в кодировке формы воспроизведения вместо (или в дополнение к) JSON
  • Не имеет нелепых серверных зависимостей.
  • В идеале, позволяет мне отправлять файлы.
  • В идеале, позвольте мне отправлять пользовательские заголовки, которые включают переменные, например, X-Auth-Code: {variable3}

Конечно, кто-то должен был это сделать?

1 ответ1

0

Нашел Swagger, который с небольшими изменениями делает все, что я хочу, включая отправку файлов и пользовательских заголовков.

Единственное, что мне пришлось исправить, - это небольшая ошибка, при которой необязательные поля POST отправляются со значением "undefined", а не опускаются полностью (или отправляются как пустые строки).

Всё ещё ищете ответ? Посмотрите другие вопросы с метками .