Plugins API HTTP Agent SDK
Commander une intégration

Intégration à l'aide de l'API HTTP

Créez des intégrations uniques avec vos plateformes.
Simplifiez votre connexion jusqu'à quelques clics.

L'API HTTP vous permet d'accéder à la plupart des fonctions disponibles dans votre espace client : gestion des ordinateurs, création de connexions en attente.

Demandes

Toutes les demandes doivent être effectuées via HTTPS (et non HTTP) avec la méthode appropriée pour chaque commande à https://api.getscreen.me/v1/

Réponses

Les réponses avec les données sont renvoyées au format JSON et encodées en UTF-8 depuis ContentType: application/json . Dans chaque réponse, les données sont encapsulées dans un conteneur JSON data

Codes de réponse :

Le serveur API peut renvoyer les codes de réponse HTTP suivants :

Code de réponse HTTP Description
200 OK Demande acceptée et traitée
400 Bad Request Demande refusée, paramètres non valides, erreurtd>
403 Forbidden Demande refusée, pas d'accès aux données
404 Not Found Demande refusée, URL de demande inconnue

Authentification

L'API est une API RESTful — le serveur ne stocke pas l'état de la connexion client. Par conséquent, chaque fois qu'une demande est envoyée, le client doit envoyer ses données d'autorisation. Une clé API est utilisée comme ces données. Ajoutez la clé dans chaque demande dans le paramètre ?apikey=

https://api.getscreen.me/v1/?apikey=YOUR_API_KEY
Votre clé API se trouve dans votre armoire personnelle dans la section "Intégration" de l'onglet HTTP API.

Méthodes

Ce sont des commandes de gestion des ordinateurs et des connexions. Nous les avons divisés en deux groupes :

  1. Accès permanent
  2. Assistance à distance

Liste des ordinateurs

Vous pouvez obtenir une liste complète des ordinateurs en utilisant la méthode devices/agents

Dans le contexte des appels d'API, les ordinateurs seront appelés «Agents», car techniquement un ordinateur est contrôlé via le programme d'agent

Demande :

GET https://api.getscreen.me/v1/agents/list
  ?apikey=<string>
Paramètres de la demande :
Paramètre Type Valeur
apikey  * string Clé API pour l'autorisation de demande

Réponse :

{
    "data":[
        {
            "id":1001,
            "name":"Allesandro Paci",
            "group":"Accounting",
            "disabled":false,
            "limited":false,
            "link_time":1587837997,
            "last_time":1600374761,
            "geo":{
                "ip":"2.21.31.68",
                "country":"USA",
                "region":"California",
                "city":"Los Angeles"
            },
            "permanent_url":"https://go.getscreen.me/paci",
            "preview_url":"https://getscreen.me/preview/1245273f5448a704379da46f476564a592efb17c6a7695adde96247cd7874416GbBzRm6SRLMqrP0YoYFMxCopL6NTzvn8.png",
            "os":"win",
            "version":"1.9.4",
            "online":true,
            "installed":true,
            "favorite":false,
            "owner":"john.smith@gmail.com",
            "sessions":{
                "last":{
                "id":148505,
                "start_time":1600343858,
                "stop_time":1600343900,
                "client":{
                    "ip":"188.162.195.82",
                    "country":"Russian Federation",
                    "region":"Tatarstan",
                    "city":"Kazan",
                    "user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.102 Safari/537.36"
                }
                },
                "total":121
            }
        },
        ...
    ]
}
Données de réponse :
Nom Type Description
id number Identifiant intra-système
name string Nom
group string Groupe
disabled boolean
L'agent est-il bloqué ?

Vous ne pouvez pas vous connecter aux agents bloqués. L'agent est bloqué en cas de dépassement de la limite du nombre d'ordinateurs dans le plan tarifaire.

limited boolean
L'agent est-il limité ?

L'agent est limité si la limite du plan tarifaire pour le nombre de fichiers joints est dépassée. 10 jours après avoir été ajouté, l'agent limité est bloqué.

link_time unixtime Date et heure de l'ajout à espace client
last_time unixtime Date et heure du dernier état en ligne
geo object Géolocalisation
geo.ip string Adresse IP
geo.country string Pays
geo.region string Région
geo.city string Ville
permanent_url string
URL de connexion permanente

Le champ peut être absent si l'accès pour les utilisateurs non autorisés est fermé

preview_url string URL pour télécharger l'aperçu de l'écran d'accueil
os string Système d'exploitation. Valeurs possibles : win, mac et linux
version string Version du programme d'agent
online boolean Statut actuel «En ligne»
installed boolean L'agent est-il installé sur l'ordinateur ?
favorite boolean S'agit-il d'un ordinateur sélectionné dans la liste de votreespace client ?
owner string Compte de propriétaire d'accès à l'ordinateur dans le système
sessions object Informations sur les connexions
sessions.last object Dernière connexion
sessions.last.id number Identifiant de connexion intra-système
sessions.last.start_time unixtime Date et heure de début de connexion
sessions.last.stop_time unixtime
Date et heure de fin de connexion

Le champ peut être absent si la connexion est active

sessions.last.client object Informations sur le client (auteur de la connexion)
sessions.last.client.ip string Adresse IP
sessions.last.client.country string Pays
sessions.last.client.region string Région
sessions.last.client.city string Ville
sessions.last.client.user_agent string Agent utilisateur du navigateur du client
sessions.total object Nombre total de connexions

Obtenir un lien pour se connecter

Pour vous connecter à un ordinateur via l'API, vous devez obtenir un lien unique en utilisant la méthode agents/connect

Le lien obtenu expire immédiatement après la première utilisation. Vous devez l'obtenir à chaque fois que vous souhaitez vous connecter.

Demande :

POST https://api.getscreen.me/v1/agents/connect
  ?apikey=<string>
  &agent_id=<number>
Paramètres de la demande :
Paramètre Type Valeur
apikey  * string Clé API pour l'autorisation de demande
agent_id  * number Identifiant d'agent intra-système

Réponse :

{
    "data": 
        {
            "url": "https://go.getscreen.me/john.smith/?connect=20177&llt=66b4kj671pm3abpp5xh17elpnpze245382m9pxbrx313l2xp52hmxqe4e1dekpej&s=c2c5ca25eb4fca787b74a97648e0856951e2b9c7aa02cbf83ac62c81e21a9bab"
        }
}
    
Données de réponse :
Nom Type Description
url string URL de connexion

Liste des connexions ouvertes

Pour obtenir une liste des connexions ouvertes à partir de la section Assistance à distance, utilisez la méthode support/list

Demande :

GET https://api.getscreen.me/v1/support/list
  ?apikey=<string>
Paramètres de la demande :
Paramètre Type Valeur
apikey  * string Clé API pour l'autorisation de demande

Réponse :

{
    "remain":100,
    "data":[
        {
            "id":328,
            "status":0,
            "create_time":1600262268,
            "invite_code":"408080316",
            "invite_url":"https://go.getscreen.me/invite/408080316",
            "connect_url":"https://go.getscreen.me/turbo/nrhaStVwQSQ1J4DW0cL4wc1ADUeyug8BZjFaCgEqT4wuFXSPXQrGoRRBUxK1uFTU1Sr7bYlsviZ0djTophpmnIhpaZuMfGSKdSefcDzOWCgJuGeHGA5hFkcflhAXhBrx",
            "client_name":"Jacob Williams",
            "client_os":"",
            "client_preview_url":""
        }
    ]
}
Données d'enregistrement de connexion :
Nom Type Description
id number Identifiant de connexion intra-système
status number
État de la connexion. Valeurs possibles :
  • 0 - Nouvelle connexion, connexion du client en attente
  • 1 - Client connecté, connexion de l'opérateur en attente
  • 2 - Connexion active, tous les participants sont connectés
  • 3 - Connexion fermée
create_time unixtime Date et heure de création de la connexion
invite_code string Code d'invitation
invite_url string URL d'invitation
connect_url string URL pour connecter l\'opérateur à la connexion
client_name string Nom du client
client_os string
Système d'exploitation. Valeurs possibles : win, mac et linux

Le champ est rempli après la connexion du client

client_preview_url string
Vignette de l'écran d'accueil du client

Le champ est rempli après la connexion du client

Informations complémentaires :
Nom Type Description
remain number Nombre de connexions restantes dans le plan tarifaire

Créer une connexion

Pour créer une connexion en attente pour l'assistance à distance, utilisez la méthode support/create

Demande :

POST https://api.getscreen.me/v1/support/create
  ?apikey=<string>
  &client_name=<string>
Paramètres de la demande :
Paramètre Type Valeur
apikey  * string Clé API pour l'autorisation de demande
client_name string Nom du client (visible uniquement par vous). Paramètre facultatif.

Réponse :

{
    "data":[
        {
            "id":328,
            "status":0,
            "create_time":1600262268,
            "invite_code":"408080316",
            "invite_url":"https://go.getscreen.me/invite/408080316",
            "connect_url":"https://go.getscreen.me/turbo/nrhaStVwQSQ1J4DW0cL4wc1ADUeyug8BZjFaCgEqT4wuFXSPXQrGoRRBUxK1uFTU1Sr7bYlsviZ0djTophpmnIhpaZuMfGSKdSefcDzOWCgJuGeHGA5hFkcflhAXhBrx",
            "client_name":"Jacob Williams",
            "client_os":"",
            "client_preview_url":""
        }
    ]
}
Participez à la connexion
Nom Type Description
id number Identifiant de connexion intra-système
status number
État de la connexion. Valeurs possibles :
  • 0 - Nouvelle connexion, connexion du client en attente
  • 1 - Client connecté, connexion de l'opérateur en attente
  • 2 - Connexion active, tous les participants sont connectés
  • 3 - Connexion fermée
create_time unixtime Date et heure de création de la connexion
invite_code string Code d'invitation
invite_url string URL d'invitation
connect_url string URL pour connecter l\'opérateur à la connexion
client_name string Nom du client
client_os string
Système d'exploitation. Valeurs possibles : win, mac et linux

Le champ est rempli après la connexion du client

client_preview_url string
Vignette de l'écran d'accueil du client

Le champ est rempli après la connexion du client

Informations sur la connexion

Pour obtenir des informations sur une connexion spécifique, utilisez la méthode support/info

Demande :

GET https://api.getscreen.me/v1/support/info
  ?apikey=<string>
  &connection_id=<number>
Paramètres de la demande :
Paramètre Type Valeur
apikey  * string Clé API pour l'autorisation de demande
connection_id  * number Identifiant de connexion intra-système

Réponse :

{
    "data":[
        {
            "id":328,
            "status":2,
            "create_time":1600262268,
            "invite_code":"408080316",
            "invite_url":"https://go.getscreen.me/invite/408080316",
            "connect_url":"https://go.getscreen.me/turbo/nrhaStVwQSQ1J4DW0cL4wc1ADUeyug8BZjFaCgEqT4wuFXSPXQrGoRRBUxK1uFTU1Sr7bYlsviZ0djTophpmnIhpaZuMfGSKdSefcDzOWCgJuGeHGA5hFkcflhAXhBrx",
            "client_name":"Jacob Williams",
            "client_os":"win",
            "client_preview_url":"https://pcommand.com/preview/f90d07668bccd418a5a8922f2ee455f1eb004c2bbeb5f9fe05ed6970c3389114Zl5PgknTWlU0fWBe4b9YoHNvRlD5Iwl5.png"
        }
    ]
}
Données de réponse :
Nom Type Description
id number Identifiant de connexion intra-système
status number
État de la connexion. Valeurs possibles :
  • 0 - Nouvelle connexion, connexion du client en attente
  • 1 - Client connecté, connexion de l'opérateur en attente
  • 2 - Connexion active, tous les participants sont connectés
  • 3 - Connexion fermée
create_time unixtime Date et heure de création de la connexion
invite_code string Code d'invitation
invite_url string URL d'invitation
connect_url string URL pour connecter l\'opérateur à la connexion
client_name string Nom du client
client_os string
Système d'exploitation. Valeurs possibles : win, mac et linux

Le champ est rempli après la connexion du client

client_preview_url string
Vignette de l'écran d'accueil du client

Le champ est rempli après la connexion du client

Fermer la connexion

Pour fermer la connexion, utilisez la méthode support/close

Demande :

POST https://api.getscreen.me/v1/support/close
  ?apikey=<string>
  &connection_id=<number>
Paramètres de la demande :
Paramètre Type Valeur
apikey  * string Clé API pour l'autorisation de demande
connection_id  * number Identifiant de connexion intra-système

Réponse :

La réponse viendra avec un contenu vide. Utilisez uniquement le code de réponse HTTP pour analyser l'exécution de la commande.

Intégration individuelle

Pas de ressources pour l'intégration personnelle?
Besoin de plus de fonctionnalités que les offres l'API HTTP?
Nous sommes prêts à proposer le développement de l'intégration individuelle d'un petit bouton dans votre application à un fournisseur OEM à part entière de services d'accès à distance.

Laisser une demande

Nous vous contacterons sous peu
Envoyer une demande
La demande a été envoyée!
Nous vous contacterons sous peu

Quelque chose manque?

S'il vous manque des méthodes ou des données dans l'API HTTP, écrivez-nous à info@getscreen.me ou dans le chat sur le site Web.
Nous examinerons votre demande et essayerons de vous aider.