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 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 !