44K Views

Api نقلة نوعية: الصابون للراحة

واجهات برمجة التطبيقات يتيح للمبرمجين بناء أداة مذهلة و التطبيقات حتى مع بيئات مختلفة.

بالنسبة لأولئك الذين قد لا تكون مألوفة مع API ،

ما Api ؟

وفقا ل wikipedia, واجهة برمجة التطبيقات (API) هي مجموعة من روتين تعريفات, البروتوكولات, و أدوات لبناء تطبيق البرمجيات. في الشروط العامة ، انها مجموعة محددة بوضوح أساليب التواصل بين مختلف مكونات البرنامج.
من جانب الخادم واجهة API يتكون عادة من توحيد الطلب-نظام الاستجابة ، وعادة ما يشار إلى خدمات ويب.

لتطوير Api ، يجب اتباع أحد نماذج التصميم مثل:

  • بقية
  • الصابون
  • تفعيل جافا
  • XML-RPC

اثنين الأبرز تصميم نماذج API الصابون بقية. الصابون المستخدمة أن تكون شعبية خيار لصنع محددة استخدام Api(s). ولكن الآن يمكنك أن ترى نقلة نوعية من الصابون للراحة. باقي تصميم نموذج اكتسبت شعبية هائلة بسبب انها البساطة و الروعة
كمطور يمكنك اتباع أي واحد وفقا لمتطلبات الخاص بك. دعونا لها نظرة عليها:

الصابون:

باختصار, الصابون(Simple Object Access Protocol) هو البروتوكول مواصفات نقل المعلومات. فإنه يوفر بقوة اكتب رسالة شكل API ، وتعتمد على صيغة XML.

soap architecture

على سبيل المثال طلب:

POST /url HTTP/1.1
Host: HostServerName
Content-type: text/xml; charset=utf-8
Content-length: 350
SoapAction: http://tempUri.org/GetUserInfo
...
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <GetUserInfo xmlns="http://tempUri.org/">
            <UserID>1</UserID>
            <OutputParam />
        </GetUserInfo>
    </soap:Body>
</soap:Envelope>

مثال الرد:

<?xml version="1.0" encoding="utf-8" ?>
<SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" ...>
    <SOAP-ENV:Body>
        <method:MethodNameResponse>
            <method:MethodNameResult xmlns=""  xsi:type="sqlresultstream:SqlResultStream">
                <!-- the results are returned here -->
            </method:MethodNameResult>
            <method:OutputParam>Value</method:OutputParam>
        </method:MethodNameResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

الراحة:

بقية هو الطراز المعماري ، على عكس الصابون الذي هو بروتوكول موحد. فإنه يجعل من استخدام HTTP ويستخدم أساليب HTTP صراحة. يمكن أن هيكل البيانات api في JSON, XML, YAML, HTML أو أي شكل آخر. سلمان هو الشكل المفضل. على عكس الصابون, أنت لا تحتاج إلى استخدام الفعل عن العمل ولكن المقابلة HTTP أساليب مثل الحصول على, وضع, حذف, بعد, التصحيح.

ReST architecture

على سبيل المثال طلب:

GET /ticket
Accept: application/json
Content-Type: application

مثال الرد:

200 OK
Content-Type: application/json
{
    "ticket": {
        "id": 11174,
        "incrementId": 82,
        "subject": "ticket subject",
        "isStarred": null,
        "isAgentView": true,
        "isTrashed": false,
        "source": "website",
        "group": null,
        "priority": {
            "id": 1,
            "name": "Low",
            "description": "Low",
            "color": "#5cb85c"
        },
        "formatedCreatedAt": "21-Dec 10:36am",
        "totalThreads": "0",
        "agent": {
            "id": 1724,
            "name": "agent name"
        },
        "customer": {
            "id": 193,
            "name": "customer name"
        },
        "hasAttachments": 0
    }
}

المزيد و المزيد من المواقع مثل uvdesk هي التالية بقية نمط تصميم.
لأن باقي لها العديد من المزايا أكثر من الصابون مثل

  1. بقية روافع HTTP, لذلك كل ما هو بسيط.
  2. في بقية البيانات uri هي الأسماء العمل المحددة من قبل HTTP أساليب مثل الحصول على, وضع, بعد, حذف, التصحيح, الرأس.
  3. Rest API(s) هي أكثر مناسبة للأجهزة النقالة. لذا ، إذا كنت قد تستخدم API لتطبيقات الجوال ثم بقية API هو الخيار الصحيح بالنسبة لك.
  4. بيانات متعددة الأشكال يمكن أن تدعم مثل سلمان ، YAML, XML, في حين الصابون يوفر فقط تنسيق XML.
  5. بقية الخدمات cacheable.
  6. عادة بقية أسرع من الصابون. منذ يستخدم تنسيق JSON بدلا من XML.
  7. بقية التالية المجتمع كبيرة جدا. لذا يمكنك أن تجد بسهولة مناسبة مكتبة بقية implementaion.

ما هي الخطوة التالية ؟

إذا كان لديك اختيار تصميم مناسب نموذج. ثم البقاء على اتصال القادمة API فئة بلوق . في القادم بلوق, يمكن أن يكون لديك نظرة على موقعنا على كامل الرحلة من API. علاوة على ذلك, سيكون هناك كل نوع من الحيل ، بتعديل النقاط الرئيسية التي تعلمناها في حين النامية بقية API.

Tag(s) api rest soap
Category(s) API uvdesk
. . .

Comment

Add Your Comment

Be the first to comment.

css.php