سال ها خدمت در زمینه تولید سامانه های تحت وب و اپلیکیشن های موبایل باعث شده است تا تیم اندیشه پرداز یکی از قوی ترین و تخصصی ترین شرکت های حوزه فناوری اطلاعات محسوب شود. اطمینان مشتریان بزرگ در سطح کشور افتخار این مجموعه بوده و جهت حفظ این سرمایه ارزشمند هر روز در تلاش برای بهبود خدمات و کیفیت محصولات می باشیم.

تماس با ما

آدرس: تهران، خیابان ولیعصر، روبروی خیابان دکتر فاطمی، کوچه عبده، پلاک 55، واحد 16

تلفن: 45382 (021)

ایمیل: info@andishehpardaz.ir

 

یکپارچگی درگاه با API ها

معرفی api درگاه

با ارائه API درگاه، شما می‌توانید بطور مستقیم با دیتابیس درگاه ارتباط برقرار کرده و در قالب‎های داده‌ای JSON، XML و یا فرمت‌های استاندارد دیگر اطلاعات را دریافت و مدیریت نمایبد. با استفاده از API شما می‌توانید با سبک نمایش متفاوت (UI) و با امکانات و قابلیت‌های سفارشی شده (UX) داده‌های درگاه را به نمایش بگذارید و آنها را مدیریت کنید.

شروع کنید

قبل از شروع لازم است بدانید که نحوه ارائه مستندات API درگاه به این ترتیب است که به صورت کاربردی قابلیت‌هایی به واسطه API در اختیار شما قرار میگیرد.

از کجا شروع کنم…

ابتدا میبایست سرویس‌های ما را درون نرم‌افزارهای خود فراخوانی کنید ما به شما یاد خواهیم داد که چگونه این ارتباط را امن نگه دارید.

احراز هویت کنید…

با توجه به کد منحصربفردی که درگاه به منظور ارتباط با وب سرویس‌ها تعبیه کرده می‌توانید به سرویس‌های ما متصل شوید و احراز هویت صورت گیرد.

ورودی و خروجی توابع چگونه می باشد…

ما برای تسهیل کار شما و امکانات بیشماری که شما انتظار آن را دارید خروجی و ورودی توابع را عموما بصورت مدل در نظر گرفتیم تا بتوانید هر آنچه نیاز دارید را وارد و با توجه به نیاز خود خروجی بگیرید.

چگونه به عناصر مدل ها دسترسی پیدا کنم…

ما در بخش تعریف مدل ها (References) به شما تمامی مدل‌ها را به همراه عناصر توضیح داده‌ایم.

آیا مثالی برای نمونه خواهم داشت…

درگاه به منظور ارائه راهکاری بهینه همچنین تهیه کدی امن و تمیز نمونه کدهای ارتباط با وب سرویس را در اختیار شما قرار داده است.

نحوه احراز هویت و استفاده از توابع توسط راهکار یکپارچه درگاه

در زیر مراحل احراز هویت توسط راهکار یکپارچه درگاه از طریق API توضیح داده شده است :

سرویس های مربوطه دارای یک آدرس ثابت می باشد که می بایست در پروژه مربوطه اضافه شود.

شرح آدرس
سرویس احراز هویت http://localhost/Services/AuthService.svc
سرویس نامه نگاری http://localhost/Services/CustomerService.svc

نحوه امن سازی سرویس های درگاه

سیستم درگاه با توجه به امن سازی پروتکل های تبادل اطلاعاتی خود، همچنین احراز هویت کاربران و رهگیری اقدامات انجام شده بستری امن در زمینه ارسال اطلاعات را فراهم کرده همچنین شما نیز میتوانید با حفظ اطلاعات خصوصی خود از این بستر استفاده نمایید.

سرویس از نوع پروتکل SOAP می باشند.

هر متد دارای تعدادی ورودی و خروجی است.

در هر متد پارامترهای Ticket و EmployeePositionCode باید به عنوان ورودی ارسال شوند.

هر سامانه ای که قصد استفاده از سرویس را داشته باشد باید دارای یک GUID منحصر به فرد در جدول [Security].[ApplicationManagement] باشد که از قبل به سیستم درگاه معرفی شده است.

به هنگام استفاده از متد در هر سرویس نیاز است توسط نام کاربری و رمز عبور مختص کاربر و سرویس AuthService و متد SignIn یک Ticket ورودی جهت مجوز ورود دریافت شود و همچنین سمت پیش فرض کاربر از طریق سرویس CustomerService و متد GetUserEmployeePosition تحت عنوان EmployeePositionCode دریافت شود و نتیجه Ticket و EmployeePositionCode به شرح زیر به همراه پارامترهای متد به عنوان ورودی ارسال شود.

در هنگام استفاده از متدهای مورد استفاده در این مستند و پر کردن آبجکت های ورودی ممکن است نیازمند استفاده از متدهای دیگر نیز باشیم. مانند دریافت لیست گیرندگان و فرستندگان، دریافت لیست نامه های مرتبط و …

using (var customerServiceClient = new CustomerServiceClient())
using (var authServiceClient = new AuthServiceClient())
{
const string username = "username";
var userModel = new FaraGostarAuthService.CredentialModel
{
Username = username,
Password = "123456"
};
var applicationGuid = new Guid("0C003558-1846-423F-98BE-87745EC77424");
var ticketModel = authServiceClient.SignIn(applicationGuid, userModel);
var ticket = ticketModel.SecureTicketId;
var employeePositionModel = customerServiceClient.GetUserEmployeePosition(ticket, 	username);
var employeePositionCode = employeePositionModel.SingleOrDefault(x => 	x.IsDefault)?.EmployeePositionCode;
var sampleResult = customerServiceClient.SomeMethod(ticket, employeePositionCode, …);
}

احراز هویت کاربر جاری

رای استفاده از سرویس های فراگستر نیاز است قبل از هر اقدامی تعیین هویت انجام شود.

جهت استفاده از تمامی متد ها در سرویس های فراگستر، نیاز است کاربر جاری تعیین هویت شود، از متد زیر جهت احراز هویت و دریافت Ticket مجوز ورود استفاده می‌کنیم.

const string username = "username";
var userModel = new FaraGostarAuthService.CredentialModel
{
Username = username,
Password = "123456"
};
var applicationGuid = new Guid("0C003558-1846-423F-98BE-87745EC77424");
var ticketModel = authServiceClient.SignIn(applicationGuid, userModel);
var ticket = ticketModel.SecureTicketId;

در اینجا فرض شده نام کاربری USERNAME و کلمه عبور ۱۲۳۴ میباشد همچنین هر سیستم که قصد دارد با API های درگاه کار کند میبایست
GUID که کدی منحصر به فرد میباشد و توسط شرکت اندیشه پرداز تولید شده را وارد نماید.