Agent Router & Gateway
Documentation technique de la passerelle unifiée Startget.tech. Architecture, routage dynamique, authentification et intégration pour applications clientes et agents autonomes.
Point d’accès universel : Chaque requête transmise à https://agent.gateway.startget.tech/v1 est analysée, validée et routée dynamiquement vers le connecteur adéquat (WhatsApp, Stripe, OpenAI, etc.) selon vos règles d’accès.
Architecture du Router
La passerelle opère comme une couche intermédiaire haute performance. Elle absorbe la complexité de chaque fournisseur (gestion des tokens, rate-limits, formats de payload) et fournit à vos applications une interface homogène et traçable.
Votre service émet un appel HTTPS standard avec votre clé Startget. La passerelle vérifie l’intégrité du token et les quotas alloués.
Le moteur identifie le connecteur cible, convertit le schéma si nécessaire et gère le basculement automatique en cas d’indisponibilité.
L’API externe est sollicitée, la transaction est consignée dans vos logs d’audit avec latence mesurée et retournée au client.
Authentification & Gestion des Clés
Toutes les requêtes vers la passerelle doivent être authentifiées via l’en-tête HTTP Authorization en utilisant le schéma Bearer. Vos identifiants se génèrent et se révoquent en temps réel depuis la Console.
Authorization: Bearer sg_live_98f4e271a09d3b14e
Content-Type: application/json
X-Startget-Service: whatsappEnvironnements isolés
Générez des clés distinctes pour vos environnements de test (sg_test_...) et de production (sg_live_...) pour éviter toute contamination de données.
Révocation instantanée
En cas de fuite de secret, révoquez immédiatement votre clé depuis la Console. La mise à jour est propagée sur les nœuds en moins de 500ms.
Envoi de requêtes & Exemples
Exemple d’appel HTTPS direct pour router un message via le connecteur WhatsApp vers un destinataire cible :
curl -X POST https://agent.gateway.startget.tech/v1/messages \
-H "Authorization: Bearer sg_live_98f4e271a09d3b14e" \
-H "Content-Type: application/json" \
-d '{"recipient": "+24107000000", "provider": "whatsapp", "text": "Bonjour depuis Startget"}'| Méthode | Endpoint | Description | Statut |
|---|---|---|---|
| POST | /v1/messages | Routage de messages WhatsApp, Telegram, etc. | Actif |
| POST | /v1/payments/charge | Initialisation de paiement (Stripe, CinetPay, PayPal) | Actif |
| GET | /v1/status | Contrôle de santé et latence de la passerelle | Actif |
API REST vs Protocole MCP
La passerelle Startget gère deux modes d’interaction distincts selon le type d'appelant :
Architecture REST classique
Idéal pour les applications web, mobiles et les backends traditionnels communiquant via requêtes HTTP synchrones et webhooks.
Model Context Protocol (MCP)
Protocole standardisé pour les agents IA autonomes (LangChain, Claude Desktop, CrewAI). Expose automatiquement les schémas de tools et fonctions exécutables.
Webhooks & Traitement d'événements
Pour traiter les événements asynchrones (messages WhatsApp reçus, paiements validés), déclarez vos URL de webhook dans la console.
- —Signature cryptographique : Chaque payload contient l’en-tête
X-Startget-Signaturecalculé en HMAC-SHA256 pour vérifier l’authenticité de la requête. - —Politique de réessai : En cas d’erreur HTTP 5xx ou de timeout de votre endpoint, la passerelle effectue jusqu’à 5 tentatives avec backoff exponentiel.
- —Idempotence garantie : Chaque événement possède un
event_idunique pour vous prémunir des doublons lors des réessais réseau.
Sécurité & Bonnes pratiques
Recommandations techniques pour déployer vos intégrations en production :
- —Stockage des secrets : Ne stockez jamais vos clés en clair dans le code client ou les dépôts publics. Utilisez des variables d’environnement côté serveur.
- —Filtrage réseau : Activez le filtrage par plage d'adresses IP sur votre Console pour restreindre les appels autorisés à vos serveurs autorisés.
- —Surveillance des quotas : Configurez des seuils d’alerte par e-mail ou webhook pour être notifié avant d’atteindre les plafonds d’appels.