به مستندات وب‌سرویس سرویس کد خوش آمدید

این صفحه راهنمای رسمی استفاده از وب‌سرویس سرویس کد (Cod) است. این وب‌سرویس بر پایه پروتکل SOAP 1.1 و با فرمت XML طراحی شده و برای ارسال درخواست و دریافت پاسخ استفاده می‌شود.

پروتکل

SOAP 1.1XML over HTTP

آدرس سرویس

http://ws.logito.ir/Cod.svc

احراز هویت

credentialنام کاربری و رمز داخل SOAP Body

نوع پیام

XMLUTF-8

شروع سریع

برای اتصال به سرویس یک پیام SOAP با ساختار زیر ارسال کنید. جزئیات کامل در صفحه شروع سریع آمده است.

POST /Cod.svc HTTP/1.1
Host: ws.logito.ir
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://tempuri.org/Cod/<نام متد>"

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header/>
  <s:Body>
    <tem:MethodName>
      <tem:credential>
        <cod:Username>...</cod:Username>
        <cod:Password>...</cod:Password>
      </tem:credential>
      <!-- سایر پارامترهای متد -->
    </tem:MethodName>
  </s:Body>
</s:Envelope>

مشاهده راهنمای کامل و نمونه‌کد PHP ←

متدهای اصلی

مبانی SOAP

وب‌سرویس شما از روش Document / Literal استفاده می‌کند. یعنی پیام به‌صورت یک سند XML کامل ارسال می‌شود و پاسخ سرویس در همان قالب برمی‌گردد. ساختار پیام از سه بخش تشکیل می‌شود:

Envelope — ریشه هر پیام SOAP؛ اگر خطایی رخ دهد در این سطح اعلام می‌شود (soap:Fault).
Header — بخش اختیاری پیام که اطلاعات جانبی در آن قرار می‌گیرد. در این سرویس خالی است.
Body — بخش اصلی که پارامترهای ورودی/خروجی و اعتبار (credential) در آن قرار می‌گیرند.

اصطلاحات پرکاربرد: فرهنگ واژگان را ببینید.

احراز هویت

برای دسترسی به سرویس باید در بدنهٔ هر درخواست، عنصر credential حاوی نام کاربری و رمز عبور را ارسال کنید؛ Header پیام خالی است. جزئیات و نمونه کامل در بخش احراز هویت توضیح داده شده است.

مشاهده راهنمای احراز هویت ←