Connexion


HTTP
golem.ai:3004/http

HTTPS
golem.ai:3005/http

Web Socket
golem.ai:3004/ws

Web Socket Sécurisé (WSS)
golem.ai:3005/ws

TCP
golem.ai:3003

Golem.ai - Documentation de l'API

En fonction de votre usage, trois possibilités pour se connecter à votre serveur Golem.ai : HTTP, Websocket ou Socket.

HTTP, Websocket ou Socket ?

HTTP Websocket TCP
Rapidité de réponse Rapide Très rapide Très rapide
Fonctionnalités accessibles Toutes Toutes Toutes
Format du protocole JSON JSON JSON
Connexion en SSL/TLS possible ? Oui - HTTPS Oui - WSS Non (à venir)
Utilisation conseillée Page web
Prototypage
Page web Serveur web
Logiciels desktop
Domotique, robotique, objets connectés

Un protocole commun

HTTP, socket et websocket partagent le même protocole.
Le mode socket et websocket permettent au moteur de répondre plus rapidement ; la connexion restant ouverte, il peut pré-calculer certaines données au moment de la connexion.


Important:

Le fonctionnement des différents modes de connexion étant harmonisé, il n'y a pas de route en mode HTTP. Toutes les connexions se font sur la même URL.
La différenciation des demandes se fait par un champ "type" contenu dans chaque paquet, quel que soit le mode de connexion.
Cette documentation précise en particulier la valeur du champ "type" pour chaque demande.


Utilisation de la console

Si votre serveur a été créé depuis la console, il faudra fournir le token de votre serveur, visible depuis la console. Ce token permet au proxy du SaaS Golem.ai de vous mettre en relation avec le bon serveur.

En mode socket/websocket, il s'agira d'une étape supplémentaire avant toute demande.
En mode HTTP, le token devra être intégré dans toute demande.

Note:

Si vous faites une application publique (page web par exemple) ce token sera public. Seul le token administrateur permet de modifier la configuration du serveur (ce token n'est pas encore visible depuis la console).


Addresse de connexion

Pour se connecter à un serveur créé depuis la console, il faut utiliser les adresses de connexion visibles en bas en gauche de la documentation.



Une question ? Un blocage ?
tech@golem.ai