Why and when use this API?
- This API is useful to get websites' ping.
How to use this API:
- You are force to sign up at this site and get your personal key to use our services.
If you have not signed up yet you can return to main page and select Sign up option from services list.
You should send your key and url address and port (optional) to this API address.
We support GET and POST methods.
API address:
- http://howdiw.ir/api/ping/
Posted parameters:
- key : your personal key
- url : the url address
- port : the port
An example for GET method:
- http://howdiw.ir/api/ping/?key=1234abcd&url=google.com
Outputs:
- ok : It may be "true" for successful procces or "false" for failure procces
- url : If true, returns url address
- port : If true, returns the port
- ping : If true, returns url ping
- description : If false, returns the cause of fail
Descriptions:
- Default port is 80
- The ping unit is miliseconds
این وبسرویس چه کاربردی دارد؟
- از این وبسرویس میتوان برای بدست آوردن پینگ سایت های گوناگون استفاده کرد
روش استفاده از وب سرویس:
- برای استفاده از این وبسرویس باید ثبتنام کرده باشید و کلید اختصاصی خود را دریافت کرده باشید.
اگر ثبتنام نکردید به صفحه اول برگردید و از لیست خدمات گزینه ثبتنام را انختاب کنید.
برای استفاده میبایست کلید خود به همراه آدرس سایت و پورت (اختباری) را به آدرس وبسرویس ارسال کنید.
ما از متد های GET و POST پشتیبانی میکنیم.
آدرس وبسرویس:
- http://howdiw.ir/api/ping/
پارامترهای ارسالی:
- key : کلید اختصاصی شما
- url : آدرس سایت مورد نظر
- port : پورت مورد نظر (اختیاری)
مثالی برای متد GET:
- http://howdiw.ir/api/ping/?key=1234abcd&url=google.com
خروجی ها:
- ok : دو حالت true و false دارد که true به معنی موفقیت آمیز بودن عملیات و false به معنی وجود خطا در عملیات است
- url : در صورت true بودن آدرس سایت مورد نظر را دربرمیگیرد
- port : در صورت true بودن پورت مورد نظر را دربرمیگیرد
- ping : در صورت true بودن پینگ سایت مورد نظر را دربرمیگیرید
- description : در صورت false بودن نوع خطا را دربرمیگیرد
توضیحات:
- در حالت پیشفرض پورت 80 است
- واحد پینگ میلی ثانیه میباشد