Einrichten der IBM Quantum Platform mit REST API

Sie können mit REST-APIs auf Quantenprozessoren zugreifen, so dass Sie mit QPUs in jeder beliebigen Programmiersprache oder jedem beliebigen Framework arbeiten können.

1. Zugang erhalten

1. Wenn Sie noch kein Benutzerkonto haben, erstellen Sie eines auf der Anmeldeseite von IBM Quantum.
2. Erstellen Sie einen API-Schlüssel (auch Token genannt) im Dashboard. Beachten Sie, dass derselbe API-Schlüssel für beide Regionen verwendet werden kann.
3. Erzeugen Sie ein IBM Cloud Identity and Access Management (IAM) Inhaber-Token. Dies ist ein kurzlebiges Token, das zur Authentifizierung von Anfragen an die REST-API verwendet wird. Um einen solchen zu erstellen, rufen Sie die IAM Identity Services API auf, wie in der folgenden Beispielanforderung gezeigt:

curl -X POST 'https://iam.cloud.ibm.com/identity/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=MY_APIKEY'

{
   "access_token": "eyJhbGciOiJIUz......sgrKIi8hdFs",
   "refresh_token": "SPrXw5tBE3......KBQ+luWQVY=",
   "token_type": "Bearer",
   "expires_in": 3600,
   "expiration": 1473188353
}

# Use 'service' to invoke operations.
import requests
import json

url = 'https://iam.cloud.ibm.com/identity/token'
api_key = 'MY_APIKEY'
headers = {
 'Content-Type': 'application/x-www-form-urlencoded',
}
data = f'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey={api_key}'
response = requests.post(url, headers=headers, data=data)

# Bearer token to authorize requests to the REST API
bearer_token = response.json()['access_token']

2. Wählen Sie eine Authentifizierungsmethode aus

Wählen Sie je nach Arbeitsumgebung die geeignete Authentifizierungsmethode:

• Erstellen Sie eine Umgebungsvariable für Ihren API-Schlüssel (vertrauenswürdige Umgebungen Python )
• Verwenden Sie Ihren API-Schlüssel direkt (nicht vertrauenswürdige Umgebung)

Erstellen Sie eine Umgebungsvariable (vertrauenswürdige Umgebung)

1. Um die Umgebungsvariable IQP_API_TOKEN in Ihrem System zu setzen, können Sie die folgende Zeile zu Ihrem Shell-Profil (z. B..bashrc oder.zshrc) hinzufügen oder sie direkt in Ihrem Terminal setzen:

   export IQP_API_TOKEN=<your-API_KEY> 
   # Use the 44-character API_KEY you created and saved 
   # from the IBM Quantum Platform Home dashboard

   Wenn Sie die Umgebungsvariable in Ihrem Code aufrufen, schließen Sie import os ein, wie in diesem Beispiel:

   import os
   api_token = os.environ['IQP_API_TOKEN']

   Beachten Sie, dass Ihr API-Schlüssel beim Erstellen einer Umgebungsvariablen immer noch lokal im Klartext gespeichert wird und daher geschützt werden sollte.

2. Authentifizieren Sie Anfragen an die REST-API, indem Sie das „ CRN “ und das „Bearer-Token“ in die Header der Anfrage aufnehmen.

curl -X 'GET' \
   'https://quantum.cloud.ibm.com/api/v1/usage' \
   '-H accept: application/json' \
   '-H authorization: Bearer <BEARER_TOKEN>' \
   '-H Service-CRN: <INSTANCE_CRN>'

3. Optional: Konfigurieren Sie Ihre Firewall

Verwenden Sie diese Informationen gegebenenfalls, um den Zugriff auf die IBM Quantum API-Endpunkte zu ermöglichen.

Nächste Schritte