Guide d'intégration API Bridge Agent

Bridge Agent expose une API REST complète pour s'intégrer à vos outils existants. Ce guide vous accompagne pas à pas.

Authentification

Obtenir votre clé API

1. Connectez-vous à votre tableau de bord

2. Menu Paramètres → API

3. Cliquez sur Générer une clé

4. Copiez et stockez la clé en sécurité

Utilisation

Toutes les requêtes doivent inclure l'en-tête :

Authorization: Bearer VOTRE_CLE_API

Endpoints principaux

Conversations

#### Envoyer un message

POST /api/conversations

Content-Type: application/json

{

"message": "Vérifie l'état de mes serveurs",

"context": {

"userId": "user_123",

"source": "wordpress-plugin"

}

}

Réponse :

{

"conversationId": "conv_abc123",

"response": "✅ Tous vos serveurs sont opérationnels...",

"actions": [

{

"type": "server_check",

"status": "completed",

"data": {...}

}

]

}

Serveurs

#### Lister les serveurs

GET /api/servers

{

"servers": [

{

"id": "srv_123",

"name": "prod-web-01",

"status": "online",

"cpu": 23,

"memory": 67,

"disk": 45

}

]

}

#### Redémarrer un serveur

POST /api/servers/:id/restart

Sauvegardes

#### Lancer une sauvegarde

POST /api/backups

Content-Type: application/json

{

"serverId": "srv_123",

"type": "full",

"destination": "s3"

}

#### Lister les sauvegardes

GET /api/backups?serverId=srv_123

Webhooks

Recevez des notifications en temps réel.

Configuration

POST /api/webhooks

Content-Type: application/json

{

"url": "https://votre-site.com/webhook",

"events": ["server.down", "backup.completed", "alert.triggered"],

"secret": "votre_secret_pour_verification"

}

Payload d'exemple

{

"event": "server.down",

"timestamp": "2025-01-15T14:30:00Z",

"data": {

"serverId": "srv_123",

"serverName": "prod-web-01",

"reason": "No response to ping"

},

"signature": "sha256=..."

}

Vérification de signature

import hmac

import hashlib

def verify_signature(payload, signature, secret):

expected = hmac.new(

secret.encode(),

payload.encode(),

hashlib.sha256

).hexdigest()

return hmac.compare_digest(f"sha256={expected}", signature)

Intégrations prêtes à l'emploi

WordPress

Plugin officiel disponible :

wp plugin install bridge-agent --activate

Configuration dans Réglages → Bridge Agent

PrestaShop

Module disponible sur marketplace :

1. Téléchargez le module

2. Uploadez via Modules → Gestionnaire de modules

3. Configurez votre clé API

WooCommerce

Compatible via le plugin WordPress. Ajoute :

Exemples d'utilisation

Script de monitoring

import requests

API_KEY = "votre_cle_api"

BASE_URL = "https://api.bridge-agent.com/v1"

headers = {

"Authorization": f"Bearer {API_KEY}",

"Content-Type": "application/json"

}

Vérifier tous les serveurs

response = requests.get(f"{BASE_URL}/servers", headers=headers)

servers = response.json()["servers"]

for server in servers:

if server["cpu"] > 80:

print(f"⚠️ {server['name']} - CPU élevé: {server['cpu']}%")

if server["disk"] > 90:

print(f"🚨 {server['name']} - Disque presque plein: {server['disk']}%")

Automatisation avec cron

#!/bin/bash

daily-backup.sh

curl -X POST https://api.bridge-agent.com/v1/backups \

-H "Authorization: Bearer $BRIDGE_API_KEY" \

-H "Content-Type: application/json" \

-d '{

"serverId": "srv_123",

"type": "incremental",

"destination": "s3"

}'

Ajouter au crontab :

0 2 * * * /path/to/daily-backup.sh

Rate limiting

En-têtes de réponse :

X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 987

X-RateLimit-Reset: 1642262400

Gestion des erreurs

Codes HTTP standard :

Format d'erreur :

{

"error": {

"code": "INVALID_SERVER_ID",

"message": "Le serveur spécifié n'existe pas",

"details": {

"serverId": "srv_999"

}

}

}

Documentation complète

API docs interactive : [api.bridge-agent.com/docs](https://api.bridge-agent.com/docs)

Support

Questions ? Contactez-nous :

[Voir la documentation API complète](#)