مهاجرت از کاوه نگار به قاصدک

راهنمای وب سرویس REST و SOAP برای مهاجرت از کاوه نگار به قاصدک

سرویس پیام کوتاه قاصدک، امکانی جدید برای مهاجرت از سرویس‌های پرکاربرد پیامکی ایرانی قرار داده است. با این امکان، برای جابجایی سرویس خود از سرویس کاوه نگار، کافیست راهنمای زیر را دنبال کنید و در کمتر از ۵ دقیقه تمام کدهای خود را به قاصدک منتقل کنید، بدون اینکه نیاز به تغییرات گسترده در کد برنامه‌های خود داشته باشید.

اگر قصد مهاجرت از کاوه نگار به قاصدک را دارید، همکاران ما در قاصدک آخرین نسخه از API این سرویس را روی قاصدک برای استفاده شما پیاده سازی کرده اند. کافیست بجای api.kavenegar.com‍ آدرس api.ghasedak.me/kavenegar را در فراخوانی های API خود جایگذاری کنید و بجای کلید API کاوه نگار از کلید API قاصدک استفاده کنید.

جهت سهولت در مهاجرت از کاوه نگار به قاصدک، SDK زبان های مختلف را مهیا کرده ایم کافیست به آدرس گیت هاب هر زبان رجوع کنید.

...

و همچنین داکیومنت REST API و انواع سرویس های پیاده سازی شده را در لیست زیر مشاهده می نمائید.

ارسال پیام کوتاه

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/sms/send.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/sms/send.json

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

ارسال گروهی پیام کوتاه

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/sms/sendarray.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/sms/sendarray.json

سرویس اعتبار سنجی (lookup)

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/verify/lookup.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/verify/lookup.json

کنترل وضعیت (Delivery)

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/sms/status.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/sms/status.json

کنترل وضعیت

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/sms/statuslocalmessageid.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/sms/statuslocalmessageid.json

اطلاعات حساب کاربری

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/account/info.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/account/info.json

انصراف از ارسال

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/sms/cancel.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/sms/cancel.json

دریافت پیامک

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/sms/receive.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/sms/receive.json

انتخاب پیامک

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/sms/select.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/sms/select.json

ارسال تماس صوتی

بجای آدرس https://api.kavenegar.com/v1/{API-KEY}/call/maketts.json آدرس زیر را قرار دهید https://api.ghasedak.me/kavenegar/v1/{API-KEY}/call/maketts.json

سایر متدها نیز به همین روال پیاده سازی شده اند.
همچنین اگر از کتابخانه‌ی خاصی در زبان‌های برنامه نویسی مختلف استفاده می کنید، میتوانید فورک ghasedak-kavenegar آن را به سادگی در مخزن گیتهاب ما پیدا کنید و اگر فورک مورد نظر خود را نیافتید، میتوانید از کمک همکاران ما برای این جابجایی استفاده کنید.

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

تنها کافیست در برنامه خود آدرس وب سرویس کاوه نگار را از https://api.kavenegar.com/soap/v1.asmx?WSDL به این آدرس http://soap.ghasedak.me/kavenegar.svc?wsdl تغییر دهید و وب سرویس خود را آپدیت نمائید.

با این تغییر آدرس دیگر نیازی به تغییر در روال کدنویسی و فانکشن ها ندارید ، فقط کافیست نام کاربری و رمز عبور و شماره خط قاصدک را جایگزین اطلاعات قبلی نمائید.

دقت داشته باشید که نام کاربری (username) در سیستم قاصدک همان API Key می باشد و رمز عبور (password) را می توانید خالی بگذارید.

مراحل آپدیت وب سرویس در پروژه های دات نت به این شکل می باشد.

1 - پروژه خود را باز کنید، در پوشه Web References وب سرویس کاوه نگار که اضافه نموده اید را مشاهده خواهید کرد.
2 - برروی اسم وب سرویس خود ( اینجا kavenegar ) کلیک راست کرده و Properties را انتخاب نمائید.
3 - در Toolbox Properties آدرس وب سرویس را مشاهده خواهید کرد.
4 - در این مرحله کافیست آدرس https://api.kavenegar.com/soap/v1.asmx?WSDL را به آدرس جدید http://soap.ghasedak.me/kavenegar.svc?wsdl تغییر دهید.
5 - و در نهایت مجددا روی وب سرویس کلیک راست کرده و گزینه Update Web Reference را انتخاب نمائید تا وب سرویس به نسخه جدید آپدیت شود.

مراحل آپدیت وب سرویس در پروژه های PHP به این شکل می باشد.

1 - کافیست فایل php که با وب سرویس کار میکند را باز کنید و آدرس وب سرویس را با آدرس جدید تغییر دهید. ( مثال متد RemainCreditByApiKey )

 

 $headers = array(
  'apikey'  =>  'your api key',
  'status'  =>  '0',
  'statusmessage'  =>  '',
 );
 $client = new \SoapClient('https://api.kavenegar.com/soap/v1.asmx?WSDL');
 $result = $client->RemainCreditByApiKey($headers);
 var_dump($result);
 echo $result->RemainCreditByApiKey;

 

 $headers = array(
  'apikey'  =>  'your api key',
  'status'  =>  '0',
  'statusmessage'  =>  '',
 );
 $client = new \SoapClient('http://soap.ghasedak.me/kavenegar.svc?wsdl');
 $result = $client->RemainCreditByApiKey($headers);
 var_dump($result);
 echo $result->RemainCreditByApiKey;

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