Skip to content
@Treblle

treblle

Stay in tune with your APIs

Treblle

Integrations   •   Website   •   Docs   •   Blog   •   Twitter   •   Discord


Treblle is a lightweight SDK that helps Engineering and Product teams build, ship & maintain REST based APIs faster.

Features




How Treblle Works

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.

Security

Masking fields

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.

Get Started

  1. Sign in to Treblle.
  2. Create a Treblle project.
  3. Setup the SDK for your platform.

Install the SDK

Install Treblle for Laravel via Composer by running the following command in your terminal:

composer require treblle/treblle-laravel

You can get started with Treblle directly from your Artisan console. Just type in the following command in your terminal:

php artisan treblle:start

The command guides you through a process and allows you to create an account, login to your existing account, create a new project and get all the .ENV keys you need to start using Treblle.

You can also visit our website https://app.treblle.com and create a FREE account to get your API key and Project ID. Once you have them, simply add them to your .ENV file:

TREBLLE_API_KEY=YOUR_API_KEY
TREBLLE_PROJECT_ID=YOUR_PROJECT_ID

Enabling Treblle on your API

Your first step should be to register Treblle into your in your middleware aliases in app/Http/Kernel.php:

protected $middlewareAliases = [
  // the rest of your middleware aliases
  'treblle' => \Treblle\Middlewares\TreblleMiddleware::class,
];

Open the routes/api.php and add the Treblle middleware to either a route group like so:

Route::middleware(['treblle'])->group(function () {

  // YOUR API ROUTES GO HERE
  Route::prefix('samples')->group(function () {
    Route::get('{uuid}', [SampleController::class, 'view']);
    Route::post('store', [SampleController::class, 'store']);
  });

});

or to an individual route like so:

Route::group(function () {
  Route::prefix('users')->group(function () {

    // IS LOGGED BY TREBLLE
    Route::get('{uuid}', [UserController::class, 'view'])->middleware('treblle');

    // IS NOT LOGGED BY TREBLLE
    Route::post('{uuid}/update', [UserController::class, 'update']);
  });
});

You're all set. Next time someone makes a request to your API you will see it in real-time on your Treblle dashboard alongside other features like: auto-generated documentation, error tracking, analytics and API quality scoring.

See the docs for this SDK to learn more.

Available SDKs

Treblle provides open-source SDKs that let you seamlessly integrate Treblle with your REST-based APIs.

See the docs for more on SDKs and Integrations.

Other Packages

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.

Community 💙

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.

Treblle Discord

Treblle YouTube

Treblle on Twitter

How to contribute

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!

Contributors

A table of avatars from the project's contributors

****

Pinned Loading

  1. treblle-laravel treblle-laravel Public

    The official Treblle SDK for Laravel. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    PHP 128 24

  2. laravel-api-boilerplate laravel-api-boilerplate Public template

    Experience the power of Treblle API Boilerplate for Laravel. Explore our latest enhancements and join a vibrant community of developers committed to optimizing API development. 🚀

    PHP 173 20

  3. treblle-node treblle-node Public

    The official Treblle SDK for NodeJS/ExpressJS/NestJS. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    JavaScript 36 3

  4. treblle-php treblle-php Public

    The official Treblle SDK for PHP. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    PHP 20 3

  5. treblle-net-core treblle-net-core Public

    The official Treblle SDK for .NET Core. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    C# 13 3

  6. treblle-spring treblle-spring Public

    The official Treblle SDK for Java. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    Java 12 2

Repositories

Showing 10 of 58 repositories
  • docs.treblle.com Public

    Treblle Documentation

    Treblle/docs.treblle.com’s past year of commit activity
    MDX 1 2 0 0 Updated Oct 31, 2024
  • treblle-docs-nextra Public

    The Treblle documentation rewrite using Nextra

    Treblle/treblle-docs-nextra’s past year of commit activity
    TypeScript 0 MIT 0 0 2 Updated Oct 16, 2024
  • treblle-net-core Public

    The official Treblle SDK for .NET Core. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    Treblle/treblle-net-core’s past year of commit activity
    C# 13 3 3 0 Updated Oct 11, 2024
  • treblle-laravel Public

    The official Treblle SDK for Laravel. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    Treblle/treblle-laravel’s past year of commit activity
    PHP 128 MIT 24 0 0 Updated Oct 11, 2024
  • Treblle/traefik-plugin-treblle-rust’s past year of commit activity
    Rust 0 0 0 0 Updated Oct 7, 2024
  • treblle-wso2 Public

    Treblle WSO2 SDK

    Treblle/treblle-wso2’s past year of commit activity
    Java 0 0 0 2 Updated Oct 5, 2024
  • treblle-ruby Public

    The official Treblle SDK for Ruby. Seamlessly integrate Treblle to manage communication with your dashboard, send errors, and secure sensitive data.

    Treblle/treblle-ruby’s past year of commit activity
    Ruby 9 MIT 3 1 3 Updated Oct 1, 2024
  • homebrew-treblle Public

    homebrew tap for treblle packages

    Treblle/homebrew-treblle’s past year of commit activity
    Ruby 0 MIT 0 0 0 Updated Oct 1, 2024
  • Treblle/treblle-cli’s past year of commit activity
    Go 18 2 0 0 Updated Oct 1, 2024
  • php-utils Public

    Treblle PHP SDK utilities.

    Treblle/php-utils’s past year of commit activity
    PHP 2 MIT 0 0 0 Updated Sep 26, 2024