blason

We love devs !

Par , le
18/02/2018 à 17:19
[Signaler]

Bonjour à tous,

Comme nous l'avons annoncé ici, nous travaillons actuellement sur des APIs, vous permettant de vous connecter de manière sécurisée au serveur de Goldheim pour récupérer des données ! :D


Pour quoi faire ?

Nous avons décidés de proposer cette fonctionnalité pour permettre à tous nos développeurs, même ceux du dimanche (:P) de faire des scripts leur permettant de faire des choses superbes pour la communauté. Par exemple, un calculateur de présence sur le serveur TeamSpeak, ou un calculateur de présence. Ou alors un système qui déclenche "Les Lacs du Connemara" lorsque OurumoV se connecte sur le serveur TS3. Bref, on vous laisse totalement libre !


Quelles limitations ?

Vous aurez possibilité d'accéder à toute les données pouvant être obtenues publiquement sur le site et les serveurs de Goldheim. Les données privées des utilisateurs (adresse mail, mot de passe, etc) ne seront bien entendu pas disponibles. Par ailleurs, pour des raisons de sécurité, l'API ne sera disponible qu'en HTTPS.


Ces API existent-elles déjà ?

Non, ces APIs n'existent pas encore et seront développées courant 2018. Nous avons eu l'idée de faire cela lorsque nous avons créé le planificateur et un système très basique permettant au navigateur Web de récupérer le nombre d'utilisateurs connectés.


Et si mon API à du succès ?

Si votre petite application rencontre un franc succès et sert de manière régulière à un grand nombre de personnes au sein de la communauté, nous vous contacterons pour que nous envisagions de directement l'incorporer au site. Ainsi, vous participez non seulement au bien de la communauté, mais en plus, vous permettez au site de se développer ! :D (Nous vous créditerons bien évidemment de vos exploits)


Des questions ?

Pour toute question, n'hésitez pas à répondre à la suite de ce sujet, ou de passer sur le canal #dev du Discord !


Artheriom
Rôle: Empereur
Jeu favori: Autre

Messages: 19
Avertissements: 0
Envoyer un Message Privé
Par , le
22/03/2018 à 21:22
[Signaler]

Pwëët (Nuch's Copyright) !


La première version de l'API avance bien. On pense déployer durant ce week-end une première version de l'API. Afin que vous puissiez commencer à vous amuser à imaginer des choses, voici une petite liste des accès qui seront à disposition. A noter bien sûr que cette liste devrait naturellement évoluer.


  • https://api.goldheim.fr/ts/list_connected.php

Cet URL renvoie, sous format JSON, le nombre de connectés, leurs pseudos et leurs identifiants TS3, ainsi que leurs temps de connexion.

Exemple :

{ "status": "Success", "data": { "number": 1, "connected": { "1": { "name": "ArtheriomLinux", "uuid": 4, "connectionTime": { "timestamp": 1, "parsedtime": { "day": 0, "hour": 0, "min": 0, "sec": 1 } } } } } }



  • https://api.goldheim.fr/ts/get_channel_info.php?cid=

Requiert de donner un numéro de channel, qui remplace . Retourne le nombre d'utilisateurs présents dans le channel, le nom du channel, son sujet, et sa place dans la hiérarchie du serveur

Exemple :

{ "status": "Success", "data": { "id": 1, "name": "Default Channel", "topic": {}, "is_password_protected": 0, "nb_users": 2, "order": { "parentChannel": 0, "orderInTree": 0 } } }



  • https://api.goldheim.fr/ts/get_group_info.php?gid=

Requiert de fournir un id de groupe. Retourne le nom du groupe, et la liste des utilisateurs en faisant partie.

Exemple :

{ "status": "Success", "data": { "id": 6, "name": "Server Admin", "members": [ 2, 4 ] } }



  • https://api.goldheim.fr/ts/get_user_info.php?uid=

Requiert de fournir un id d'utilisateur. Retourne les informations de l'utilisateurs telles que son surnom actuel, sa date de première et dernière connexion au serveur, son nombre de connexions et son statut de connexion. S'il est connecté, retourne également le canal où il se situe actuellement, son statut présent/absent avec, éventuellement, son message d'absence, le statut de ses périphériques et de l'enregistrement, les groupes auxquels l'utilisateur est affecté, ainsi que le client sur lequel il est.

Exemple :

{ "status": "Success", "data": { "name": "Artheriom", "uuid": 2, "firstLoginTime": 1519584577, "lastLoginTime": 1521749821, "nbConnections": 10, "isConnected": 1, "connectionInfo": { "channelId": 1, "away": { "isAway": 0, "awayMessage": null, "inactivityTime": 411 }, "talkStatus": { "isInputMuted": 0, "isOutputMuted": 0, "isPrioritySpeaker": 0, "isRecording": 0 }, "groups": [ 6, 7 ], "client": "Linux" } } }



Artheriom
Rôle: Empereur
Jeu favori: Autre

Messages: 19
Avertissements: 0
Envoyer un Message Privé