From this site you'll find detailed information about our platform development practices. This is not APInf Platform user guide.
Intended audience is people who develop the platform regardless of are they employees of APInf Oy or community members.
APInf platform offers a comprehensive, yet easy to use API management tool. APInf provides simplified workflow for API owners for common API management tasks so you can focus on building your APIs.
You can publish your API in the APInf catalog without connecting it to a proxy. But connecting the API provides you with the possibility to use traffic management features, authorization and logging. The proxy acts as a façade for your API: the API clients are not accessing your API directly. You can manage both REST APIs and Iot APIs (MQTT) with APInf.
Publishing your API in the catalog gives better visibility for your API. The API can be published with one single step: fill in the access URL, name and description and get going! We highly recommend also adding a logo for your API – after all the API should be an easily identifiable product.
You can provide an OpenAPI documentation file for your API by uploading a file or providing a link to your file. Good API documentation saves frustration from developers and minimizes support needs from them. They can not only read the document, they can try out the calls in practice.
If you connect your API to the proxy, you can follow your API traffic and different API KPIs in the dashboard. You can monitor API response times, HTTP response types, numbers of users and most frequent users for the selected time frames. This allows you to identify for example your most popular APIs, traffic peaks or performance problems.
APInf roadmap is decided inside the team. Decisions are business driven, but take into account technical requirements and limitations. Our roadmap is "event driven" which means that we pick bigger ICT events as milestones.
We use EUPL license for core components.
Easiest way to follow development is to look at issues in Waffle. Other option is to use Github issues list.
For new issues we have template in Github which will guide you to fill in needed information.
We use automated testing. This means that you start developing new features by defining test first. Platform APIs have own testing process. See below.
Start developing the platform by installing APInf platform. You can do this multiple ways. Here's more detailed information how to do it.
We have three instances running. Each of them have different purpose.
- Our production enviroment is available at apinf.io This is our SaaS version
- Staging, https://staging.apinf.io is for maturing the next version before launch to production (see above)
- Nightly, https://nightly.apinf.io is our nightly build version of the platform.
Our platform contains multiple APIs. What ever can be done from GUI, you can do it with API. For each platform API we have two branches:
- production (with multiple versions) and
- design (the future version)
Production API is the live one and fully functional version. The design has been frozen. It might change, but changes are not backwards breaking. Design branch is the next API version (minor/major changes).
Read API Design Guide for details.
- We utilize Postman in platform API testing.
- All tests generated by Postman.
- Tests released in platform github repository under ....
Detailed information about testing practices and tools in API testing documentation.
- Catalog API (Production version 1 and Development branch)
- Management API (Production version 1)
- Analytics API (Development branch)
In APInf we use unified process for Platform API development. Platform APIs are non-profit APIs. Our intention is not to charge clients for using them. They are part of the platform.
We use OpenAPI spec version 2.0 in API design and documentation.
Code related to APIs can be found from here
We have defined set of rules for API development.
What is APIBot?
What is Open API Designer