يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
في هذا البرنامج التعليمي، يمكنك إنشاء مواصفات OpenAPI لتصميم واجهة برمجة تطبيقات تستدعي خادمًا مستهدفًا. يتكون الخادم الهدف من خادم بسيط جدًا يستند إلى Node.js ويمكنك إنشاؤه وتشغيله على جهازك. يستغرق إكمال هذا الدليل التوجيهي حوالي 10 دقائق.
ما ستتعرَّف عليه
ستتعرّف في هذا البرنامج التعليمي على كيفية:
- إنشاء خادم Node.js بسيط
- إنشاء مواصفات OpenAPI التي تصمم واجهة برمجة التطبيقات التي تستدعي خادم Node.js
المتطلبات
إليك ما ستحتاج إليه للبدء:
- حساب Apigee Edge (يُرجى الاطّلاع على إنشاء حساب Apigee Edge)
- أحدث إصدار من Node.js
- أداة سطر الأوامر curl
- محرِّر النصوص
إنشاء خادم Node.js بسيط
لإنشاء خادم Node.js بسيط:
- أنشئ ملفًا باسم
index.js
. انسخ رمز Node.js التالي في الملف:
var express = require('express'); var app = express(); app.get('/v1/hello', function (req, res) { res.setHeader("Access-Control-Allow-Origin", "*"); res.send('Hello World!\n'); }); app.listen(3000, function () { console.log('Example app listening on port 3000!'); });
احفظ الملف.
ثبِّت وحدة Express المطلوبة:
npm install express
ابدأ تشغيل الخادم:
node index.js
يتم عرض الرسالة التالية:
Example app listening on port 3000
اختبِر واجهة برمجة التطبيقات عن طريق إرسال طلب HTTP التالي.
curl localhost:3000/v1/hello
وتعرض واجهة برمجة التطبيقات النص التالي: Hello World!
إنشاء مواصفات OpenAPI
لإنشاء مواصفات OpenAPI التي تصمم واجهة برمجة التطبيقات التي تستدعي خادم Node.js.
- سجِّل الدخول إلى apigee.com/edge.
- اختَر التطوير > المواصفات في شريط التنقّل الجانبي.
يتم عرض قائمة بالمواصفات. انقر على + مواصفات وحدد مواصفات جديدة في القائمة المنسدلة.
انسخ محتوى YAML التالي:
swagger: "2.0" info: version: "0.0.1" title: Hello World API host: 127.0.0.1:3000 basePath: /v1 schemes: - http consumes: - application/json produces: - application/json paths: '/hello': get: description: Returns greetings to the caller operationId: hello responses: "200": description: Success schema: $ref: "#/definitions/HelloWorldResponse" default: description: Error schema: $ref: "#/definitions/ErrorResponse" definitions: HelloWorldResponse: required: - message properties: message: type: string age: type: number ErrorResponse: required: - message properties: message: type: string
الصق محتوى YAML في الجزء الأيسر من المحرر (استبدال المحتوى الحالي).
انقر على حفظ.
سيُطلب منك تسمية المواصفات.أدخِل اسمًا للمواصفات، مثل: simple-spec.
انقر على متابعة.
تم حفظ المواصفات.انقر على إغلاق لإغلاق المواصفات والانتقال إلى قائمة المواصفات.
يتم عرض المواصفات الجديدة في قائمة المواصفات.
ما هي الخطوات التالية؟
تهانينا! لقد أنشأت أول مواصفات OpenAPI لتصميم واجهة برمجة تطبيقات تستدعي الخادم المستهدف.
بعد ذلك، تعرَّف على كيفية إنشاء خادم وكيل لواجهة برمجة التطبيقات من مواصفات OpenAPI.