الإعداد لاستخدام IBM Quantum Platform عبر REST API

يمكنك الوصول إلى المعالجات الكمومية عبر REST APIs، مما يتيح لك العمل مع وحدات معالجة الكم (QPUs) باستخدام أي لغة برمجة أو إطار عمل.

1. احصل على صلاحية الوصول

1. إذا لم يكن لديك حساب مستخدم بعد، أنشئ واحدًا من صفحة تسجيل الدخول إلى IBM Quantum.
2. أنشئ مفتاح API (يُعرف أيضًا بالرمز المميز) من لوحة التحكم. لاحظ أن نفس مفتاح API يمكن استخدامه في أي من المنطقتين.
3. أنشئ رمز bearer الخاص بـ IBM Cloud Identity and Access Management (IAM). هذا رمز قصير الأمد يُستخدم للتحقق من طلبات REST API. لإنشائه، استدعِ واجهة برمجة تطبيقات IAM Identity Services كما هو موضح في المثال التالي:

Curl

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
}

Python

# 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-urlendcoded',
}
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. اختر طريقة المصادقة

اختر طريقة المصادقة المناسبة بحسب بيئة عملك:

• أنشئ متغير بيئة لمفتاح API الخاص بك (بيئات Python الموثوقة)
• استخدم مفتاح API مباشرة (بيئة غير موثوقة)

إنشاء متغير بيئة (بيئة موثوقة)

1. لضبط متغير البيئة IQP_API_TOKEN على نظامك، يمكنك إضافة السطر التالي إلى ملف إعدادات الشِل الخاص بك (مثل .bashrc أو .zshrc) أو ضبطه مباشرة في الطرفية:

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

   عند استدعاء متغير البيئة في الكود الخاص بك، أضف import os كما في هذا المثال:

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

   لاحظ أنه عند إنشاء متغير بيئة، يظل مفتاح API مخزنًا محليًا كنص عادي، لذا يجب حمايته بعناية.

2. صادق على طلبات Qiskit Runtime REST API بتضمين CRN ورمز bearer في ترويسات الطلب.

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. اختياري: اضبط جدار الحماية الخاص بك

إذا لزم الأمر، استخدم هذه المعلومات لتفعيل الوصول إلى نقاط نهاية IBM Quantum API.

الخطوات التالية

توصيات

• نظرة عامة على الخطط المتاحة.
• اضبط Qiskit SDK محليًا.
• اتبع الخطوات في Hello world لكتابة برنامج كمومي وتشغيله.
• جرّب أحد الدروس التعليمية.