Treblle is a lightweight SDK that helps Engineering and Product teams build, ship & maintain REST based APIs faster.
- API Monitoring & Observability
- Auto-generated API Docs
- API analytics
- Treblle API Score
- API Lifecycle Collaboration
- Native Treblle Apps
Once you’ve integrated a Treblle SDK in your codebase, this SDK will send requests and response data to your Treblle Dashboard.
In your Treblle Dashboard you get to see real-time requests to your API, auto-generated API docs, API analytics like how fast the response was for an endpoint, the load size of the response, etc.
Treblle also uses the requests sent to your Dashboard to calculate your API score which is a quality score that’s calculated based on the performance, quality, and security best practices for your API.
Visit https://docs.treblle.com for the complete documentation.
Masking fields ensure certain sensitive data are removed before being sent to Treblle.
To make sure masking is done before any data leaves your server we built it into all our SDKs.
This means data masking is super fast and happens on a programming level before the API request is sent to Treblle. You can customize exactly which fields are masked when you’re integrating the SDK.
Visit the Masked fields section of the docs for the complete documentation.
- Sign in to Treblle.
- Create a Treblle project.
- Setup the SDK for your platform.
Install the necessary packages
pip install -r requirements.txt
A treblle.json
file has to be present in the root directory of the project. This file should contain a dictionary like the example below:
{
"TREBLLE_API_KEY": "API key goes here",
"TREBLLE_PROJECT_ID": "Project ID goes here",
"TREBLLE_HIDDEN_KEYS": ["hidden", "keys", "goes", "here"]
}
Don't forget to add
treblle.json
to .gitignore file
Once that is out of the way, the next step is to import the Treblle class and pass the app
instance:
from treblle-flask import Treblle
...
Treblle(app)
...
That is all it takes to set up the Treblle-flask SDK.
Two ways to run the server:
flask --app main run
To run in debug mode:
flask --app main --debug run
There are also test files available, to run tests:
cd treblle_flask
cd test
- run:
pytest
orpytest -v
(to view test cases)
Tip: Ensure treblle.json is present in project directory and test directory (just for testing purpose, don't forget to add to .gitignore) ;-)
- Create user -->
http://127.0.0.1:5000/signup
- Login -->
http://127.0.0.1:5000/signin
- All articles -->
http://127.0.0.1:5000/
, { Bearer 'token' } - Create article -->
http://127.0.0.1:5000/
, { Bearer 'token' } - Fetch article -->
http://127.0.0.1:5000/:uuid
, { Bearer 'token' } - Update article -->
http://127.0.0.1:5000/:uuid
, { Bearer 'token' } - Delete article -->
http://127.0.0.1:5000/:uuid
, { Bearer 'token' }, pass {} as body.
See the docs for this SDK to learn more.
Treblle provides open-source SDKs that let you seamlessly integrate Treblle with your REST-based APIs.
treblle-laravel
: SDK for Laraveltreblle-php
: SDK for PHPtreblle-symfony
: SDK for Symfonytreblle-lumen
: SDK for Lumentreblle-sails
: SDK for Sailstreblle-adonisjs
: SDK for AdonisJStreblle-fastify
: SDK for Fastifytreblle-directus
: SDK for Directustreblle-strapi
: SDK for Strapitreblle-express
: SDK for Expresstreblle-koa
: SDK for Koatreblle-go
: SDK for Gotreblle-ruby
: SDK for Ruby on Railstreblle-python
: SDK for Python/Django
See the docs for more on SDKs and Integrations.
Besides the SDKs, we also provide helpers and configuration used for SDK development. If you're thinking about contributing to or creating a SDK, have a look at the resources below:
treblle-utils
: A set of helpers and utility functions useful for the JavaScript SDKs.php-utils
: A set of helpers and utility functions useful for the PHP SDKs.
First and foremost: Star and watch this repository to stay up-to-date.
Also, follow our Blog, and on Twitter.
You can chat with the team and other members on Discord and follow our tutorials and other video material at YouTube.
Here are some ways of contributing to making Treblle better:
- Try out Treblle, and let us know ways to make Treblle better for you. Let us know here on Discord.
- Join our Discord and connect with other members to share and learn from.
- Send a pull request to any of our open source repositories on Github. Check the contribution guide on the repo you want to contribute to for more details about how to contribute. We're looking forward to your contribution!