- Documentation - APInf documentation
- Discussion - APInf discussion
- Apinf Hackpad - Planning documents, meeting minutes
- Sprint planning - waffle.io sprint plans
The APInf platform offers a comprehensive tool for API management. Building on API Umbrella, it provides enhanced user interface features for API managers and consumers alike.
For API consumers APInf provides simple key management, key usage analytics and API discovery along with API documentation. Managers have simplified workflow for common tasks, such as key management, rate limiting and viewing API usage analytics.
Diagrams of the Apinf minimum viable product (MVP) architecture and ecosystem.
For the ecosystem, we will concentrate on open APIs in the MVP phase. For the API consumer side, there are two API consumer personas: Jukka and Minh. API owner personas to be added later.
- Install API Umbrella (or follow the Developer Setup)
- Install Meteor.js
- Clone Apinf
- Run
npm install - Type
meteorin the project directory
- Run API-umbrella container http://api-umbrella.readthedocs.io/en/latest/getting-started.html#running-with-docker
- Obtaining API Key and Authentication token. You can obtain the Authentication Token and API Key from the API Umbrella platform by following instructions in the Getting Started and API Umbrella Admin API documentation.
- Run APInf container
docker run -p 8080:80 -e MONGO_URL=mongodb://localhost:27017/your_db -e MAIL_URL=smtp://some.mailserver.com:25 -e ROOT_URL=http://YOUR_SITE_DOMAIN apinf/apinf:latest - Configure APInf
Register a new admin account. The first user will become Admin.
- Signup to the APInf http://YOUR_SITE_DOMAIN/sign-up
- Login to the APInf web admin http://YOUR_SITE_DOMAIN/sign-in
- Fill APInf settings http://YOUR_SITE_DOMAIN/settings
- Create "docker-compose.yml" file on your server and copy content from docker-compose.yml.
- In the same folder create file "docker/api-umbrella/config/api-umbrella.yml" based on example "docker/api-umbrella/config/api-umbrella.yml.example". ATTENTION: replace "example.com" on YOUR_SITE_DOMAIN for keys "ssl_cert" and "ssl_cert_key".
- Create file "docker/apinf/env" based on example "docker/apinf/env.example".
- Create file "docker/ssl/env" based on example "docker/ssl/env.example".
- Run
docker-compose up -d. The first launch of will be slow because (take couple of minutes) of the DH parameter computation and configure Let's Encrypt certificate. - Visit https://YOUR_SITE_DOMAIN:3002/signup/ and fill form for get API Key.
- Visit https://YOUR_SITE_DOMAIN:3002/admin/ and click on 'My Account' link for find Admin API Token.
- Visit https://YOUR_SITE_DOMAIN/sign-up and create new account.
- Fill data in "Project Branding: APINF Configuration Wizard".
- Fill data in "Settings for API Umbrella: APINF Configuration Wizard".
- Host: "https://YOUR_SITE_DOMAIN:3002"
- API Key: from step #6
- Auth Token: from step #7
- Base URL: "https://YOUR_SITE_DOMAIN:3002/api-umbrella/"
- Elasticsearch: "http://YOUR_SITE_DOMAIN:14002"
- Add API backend https://YOUR_SITE_DOMAIN/api/new
The mail object contains a username and password for the Mailgun service. You will need to register with Mailgun. Once registered, you can use your 'sandbox' domain credentials in a development environment or a custom domain in production:
- Default SMTP Login
- Default Password
For up-to-date instructions, refer to the Mailgun Help Center
Elasticsearch takes a host value that contains the host and port of the API Umbrella ElasticSearch instance. In a standard API Umbrella deployment, this will be the same as the API Umbrella base URL, with port number 14002. Note: Elastic REST API may be exposed via HTTP instead of HTTPS, so double check the protocol.
The Github configuration takes two values, a Client ID and Secret key. You can obtain these values by setting up a Github application from your Github user account.
You can preview our latest version at nightly.apinf.io.
- username: [email protected]
- password: testuser
Please review our Contributor Guide for details on how to get involved with the project.