Premiers pas avec Cisco Spark REST-API

Je souhaite accéder à Cisco Spark avec REST-API

Le contenu d'apprentissage est disponible sur Cisco DevNet (https://developer.cisco.com/site/devnet/home/index.gsp) (DevNet> Collaboration> Spark for Developers dispose de 3 laboratoires d'apprentissage) ..

• Learning Lab #1: Rooms and Messages
• Learning Lab #2: App Registration and Authentication
• Learning Lab #3: Webhooks

Il est soigneusement conçu, donc si vous suivez les étapes, vous apprendrez tout sur "Comment accéder à Cisco Spark via REST-API en utilisant POSTMAN".

Dans l'étape suivante, je résumerai comment changer POSTMAN en Python.

Obtenir un jeton d'accès

Un jeton d'accès est requis pour accéder à Cisco Spark via REST-API. Le jeton d'accès est une chaîne d'authentification donnée à une personne lors de son inscription auprès de Cisco Spark. Obtenez-le de la manière suivante:

https://developer.ciscospark.com/ Accédez et connectez-vous.

• Si vous n'avez pas enregistré Cisco Spark, vous devez vous inscrire.

Si vous vous connectez avec succès, un avatar (une icône avec un visage humain) sera affiché dans le coin supérieur droit.

Cliquez sur l'avatar pour voir le jeton d'accès. Le jeton d'accès est une information qui ne doit jamais être connue des autres, il faut donc faire attention lors de sa manipulation.

Expérience 1: obtenir une liste de salles auprès de Cisco Spark

Référence: Référence de l'API Cisco Spark (https://developer.ciscospark.com/endpoint-rooms-get.html)

Exécutez http GET dans les conditions suivantes:

• URI: https://api.ciscospark.com/v1/rooms
• Headers: Authorization: Bearer (Access Token)
• Headers: Content-Type: application/json

Utilisez requests pour effectuer un HTTP GET en Python. Le code est, par exemple:

import requests

access_token = 'Entrez le jeton d'accès ici'

url = 'https://api.ciscospark.com/v1/rooms'
headers = {
    'Authorization' : 'Bearer ' + access_token,
    'Content-Type' : 'application/json'
}

r = requests.get(url, headers = headers)

print(r.json())

Si vous souhaitez simplement récupérer l'ID de la salle, remplacez print (r.json ()) sur la dernière ligne par:

for line in r.json()['items']:
    print line['id']

Expérience 2: Obtenir un message de salle de Cisco Spark

Pour obtenir le message, utilisez l'ID de salle obtenu dans l'expérience 1 et exécutez http GET dans les conditions suivantes:

• URI: https://api.ciscospark.com/v1/messages
• Headers: Authorization: Bearer (Access Token)
• Headers: Content-Type: application/json
• Payload: 'roomId' : (Room ID)

Voici un exemple de script qui affiche l'ID de messagerie et le message de l'utilisateur:

# -*- coding: utf-8 -*-

import requests

urlr = 'https://api.ciscospark.com/v1/rooms'
urlm = 'https://api.ciscospark.com/v1/messages'
headers = {
    'Authorization' : 'Bearer ' + access_token,
    'Content-Type' : 'application/json'
}

r = requests.get(urlr, headers = headers)

for line in r.json()['items']:
    payload = {'roomId' : line['id']}
    print '################### Room: ', line['title']
    r2 = requests.get(urlm, headers = headers, params = payload)
    try:
        for mline in r2.json()['items']:
            try:
                print mline['personEmail'], '>>>', mline['text']
            except KeyError:
                pass
    except KeyError:
        pass

• 2017/8/1 Le contenu a été légèrement révisé.