---
title: "Nouvelle fonctionnalité : Filtres universels pour l’API incwo"
url: "https://go.incwo.com/blog/nouvelle-fonctionnalite-filtres-universels-pour-lapi-incwo/"
type: "blog-post"
date: "2025-08-28T07:48:00.000Z"
author: "Guillaume Besse"
categories: []
summary: "Nous venons d’ajouter une fonctionnalité puissante à l’API incwo : les filtres universels. Cette nouveauté permet de filtrer vos données avec une précision et une flexibilité inégalées. Qu’est-ce que les filtres universels ? Les filtres universels permettent de filtrer n’importe quel champ de vos objets incwo via un seul paramètre : ufilters. Plus besoin de se limiter […]"
---

# Nouvelle fonctionnalité : Filtres universels pour l’API incwo

Nous venons d’ajouter une fonctionnalité puissante à l’API incwo : **les filtres universels**. Cette nouveauté permet de filtrer vos données avec une précision et une flexibilité inégalées.

## Qu’est-ce que les filtres universels ?

Les filtres universels permettent de filtrer n’importe quel champ de vos objets incwo via un seul paramètre : `ufilters`. Plus besoin de se limiter aux filtres prédéfinis, vous pouvez maintenant créer des requêtes sur mesure.

## Comment ça fonctionne ?

### Format simple

Le paramètre `ufilters` accepte un objet JSON :

```
{
  "ufilters": {
    "nom_du_champ": {
      "opérateur": "valeur"
    }
  }
}
```

### Opérateurs disponibles

-   **`eq`** : égal à
-   **`ne`** : différent de
-   **`gt`**, **`gte`** : supérieur (ou égal)
-   **`lt`**, **`lte`** : inférieur (ou égal)
-   **`like`** : contient (avec %)
-   **`in`** : dans une liste
-   **`null`** : est null (true/false)
-   **`date_gte`**, **`date_lte`** : filtres de dates

## Exemples concrets

### Trouver les contacts avec un email Gmail

```
GET /contacts.json?ufilters={"email":{"like":"%@gmail.com"}}
```

### Lister les tâches prioritaires

```
GET /tasks.json?ufilters={"priority":{"gte":3}}
```

### Contacts créés cette année

```
GET /contacts.json?ufilters={"created_at":{"date_gte":"2025-01-01"}}
```

### Filtres multiples

```
GET /contacts.json?ufilters={"first_name":{"like":"Jean%"},"age":{"gte":25,"lte":50}}
```

## Avantages

### **Flexibilité totale**

Filtrez sur n’importe quel champ de vos objets

### **Combinaisons illimitées**

Combinez autant de critères que nécessaire

### **Compatible partout**

Fonctionne sur tous les endpoints (contacts, tâches, factures, etc.)

### **Rétrocompatible**

N’impacte pas vos intégrations existantes

## Cas d’usage

### Reporting avancé

Créez des rapports précis avec des critères métier spécifiques

### Synchronisation optimisée

Synchronisez uniquement les données qui vous intéressent

### Tableaux de bord

Affichez des données filtrées en temps réel

### Analyses ciblées

Extrayez des données selon vos besoins business

## Intégration

### Ruby

```
filters = { name: { like: "%Dupont%" }, status: { eq: "active" } }
RestClient.get("#{server}/contacts.json", params: { ufilters: filters.to_json })
```

### Python

```
filters = {"name": {"like": "%Dupont%"}, "status": {"eq": "active"}}
requests.get(f"{server}/contacts.json", params={"ufilters": json.dumps(filters)})
```

### JavaScript

```
const filters = { name: { like: "%Dupont%" }, status: { eq: "active" } };
fetch(`${server}/contacts.json?ufilters=${encodeURIComponent(JSON.stringify(filters))}`);
```

## Sécurité

-   Protection contre l’injection SQL
-   Validation des données d’entrée
-   Gestion d’erreurs robuste
-   Respect des permissions existantes

## Disponibilité

Les filtres universels sont **disponibles dès maintenant** sur tous nos serveurs. La fonctionnalité est activée progressivement et sera bientôt accessible à tous nos utilisateurs.

## Documentation

Retrouvez la documentation complète sur notre [portail développeur](https://www.incwo.com/site/developers) avec :

-   Guide de référence détaillé
-   Exemples de code
-   Cas d’usage avancés
-   Guide de dépannage

## Support

Cette fonctionnalité s’inscrit dans notre démarche d’amélioration continue de l’API Incwo. Nous continuons de développer des outils puissants et flexibles pour répondre à vos besoins.

**Testez dès maintenant les filtres universels et découvrez de nouvelles possibilités !**