Apiary vs Swagger2Markup
Apiary
apiary.ioSwagger2Markup
github.comSide by side
| Figure | Apiary | Swagger2Markup |
|---|---|---|
| Price from | Free | — |
| Free plan | Yes | — |
| Free trial | — | — |
| Open source | — | — |
| Web | Yes | — |
| Linux | — | Yes |
| API | Yes | Yes |
| Self-hosted | — | Yes |
| Plans published | 3 | 0 |
| Spec score · API Documentation Tools | 8.0 (#8) | 7.0 (#27) |
| Integrations | Apiary offers GitHub sync, with branch based GitHub integration available on Pro according to its help page. | The project documents use with Swagger JAX-RS, Springfox, Spring REST Docs, and Gradle and Maven plugins. |
| Support | Pro includes priority support with guaranteed 24x7 response times from a dedicated support team. | The project README directs questions to Gitter and asks users to report bugs and enhancement requests through GitHub issues and pull requests. |
Plans
In their own words
Apiary
Apiary is a hosted web platform for designing, documenting, prototyping, and testing APIs. Its editor supports API Blueprint and OpenAPI (Swagger), with instant validation and a live preview as descriptions are written. Publishing a description creates a mock server that returns the responses specified in it; the default limit is 120 requests per minute, or 5,000 with authentication. Automated tests compare real API responses with expectations generated from the description. Apiary also supports OpenAPI import, interactive references, code samples, and API versioning. Teams can manage document access with Admin, Editor, and Viewer roles, and sync with GitHub. Branch-based GitHub integration is available on Pro. The free plan costs nothing and permits unlimited API projects and five participants per project, but projects are public and teams are not included. Standard and Pro are deprecated, with plan changes handled by support request for current customers. Embedding interactive documentation is supported on Standard and Pro.
Swagger2Markup
Swagger2Markup has no write-up on Specifiction yet; its figures are above.