API REST
Intégrez les données et fonctionnalités de Selery dans vos applications avec notre API REST moderne, sécurisée et parfaitement documentée.
Endpoints disponibles
Propriétés
Gestion du patrimoine immobilier
Locataires
Gestion des locataires et baux
Finances
Données comptables et fiscales
Analytics
Métriques et rapports
Exemples d'utilisation
/api/v1/propertiesRécupérer la liste des propriétés
Commande cURL
curl -X GET \
https://api.selery.io/v1/properties \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Réponse JSON
{
"data": [
{
"id": "prop_123",
"type": "apartment",
"address": "123 Rue de la République, Lyon 6ème",
"surface": 65,
"rooms": 3,
"rent": 1250,
"yield": 6.2,
"tenant": {
"name": "Marie Dupont",
"lease_start": "2023-09-01"
}
}
],
"meta": {
"total": 18,
"page": 1,
"per_page": 10
}
}Fonctionnalités de l'API
Authentification et sécurité
Sécurisez vos intégrations avec nos méthodes d'authentification robustes.
Configuration de l'API Key
curl -H "Authorization: Bearer sk_live_1234567890abcdef" \\
https://api.selery.io/v1/propertiesEnvironnement de test
sk_test_...Données sandbox pour développement
Environnement de production
sk_live_...Données réelles de votre compte
SDKs et bibliothèques officielles
Accélérez votre développement avec nos SDKs officiels dans les langages populaires.
JavaScript
SDK officiel pour Node.js et navigateurs
Installation
npm install @selery/sdkExemple d'utilisation
import { SeleryAPI } from '@selery/sdk';
const client = new SeleryAPI({
apiKey: 'your-api-key'
});
const properties = await client.properties.list();Python
Bibliothèque Python pour intégrations backend
Installation
pip install selery-pythonExemple d'utilisation
from selery import SeleryClient
client = SeleryClient(api_key='your-api-key')
properties = client.properties.list()PHP
Package Composer pour applications PHP
Installation
composer require selery/php-sdkExemple d'utilisation
use Selery\SeleryClient;
$client = new SeleryClient('your-api-key');
$properties = $client->properties()->list();Fonctionnalités avancées
Exploitez toute la puissance de notre API avec des fonctionnalités enterprise.
Authentification sécurisée
API Keys et OAuth 2.0 pour un accès sécurisé
Temps réel
WebSockets pour les mises à jour instantanées
Pagination intelligente
Gestion optimisée des grandes collections
Rate limiting
Protection contre les abus et surcharge
Documentation interactive
Swagger/OpenAPI avec tests en ligne
Versioning
Compatibilité ascendante garantie
Limites et performance
Rate Limit
Requêtes par minute
Latence
Temps de réponse moyen
Uptime
Disponibilité garantie
Gestion des erreurs
Codes de statut HTTP
- • 200 - Succès
- • 400 - Requête invalide
- • 401 - Non autorisé
- • 429 - Limite de taux atteinte
- • 500 - Erreur serveur
Format des erreurs
{
"error": {
"type": "invalid_request",
"message": "Missing required field",
"field": "address"
}
}Bonnes pratiques d'intégration
Optimisation des performances
- • Utilisez la pagination pour les grandes listes
- • Implémentez un cache pour les données statiques
- • Filtrez les champs avec le paramètre ?fields=
- • Utilisez les WebSockets pour le temps réel
Sécurité et fiabilité
- • Stockez les clés API de manière sécurisée
- • Implémentez un retry avec backoff exponentiel
- • Validez toujours les données en entrée
- • Surveillez vos quotas d'utilisation