در مقاله های قبل در مورد آشنایی با وب سرویس ادتو و وب سرویس ادتو توضیح دادیم در این مقاله در مورد مستندات استفاده از REST API در ادتو توضیح خواهیم داد.
شروع
برای شروع کار با سامانه اول نیاز دارید تا در سیستم ثبت نام کنید و پس از معرفی خودتون به عنوان نمایشدهنده، سیستم به شما یک کلید نمایشدهنده (Publisher Key) و یک کلید رمز (Secret Key) اختصاص میده که با استفاده از اون میتونید با API ارتباط برقرار کنید(مستندات استفاده از REST API در ادتو).
کلید نمایشدهنده (Publisher Key)
جهت درخواست ایجاد تصویر امنیتی شما میبایست از کلید نمایشدهنده که سیستم براتون اختصاص داده استفاده بکنید.
کلید رمز (Secret Key)
جهت اعتبارسنجی پاسخ کاربران باید از کلید رمز که سیستم براتون اختصاص داده استفاده بکنید. دقت کنید که این کلید میبایست به صورت ایمن از سمت شما به API ارسال بشه (در backend) و کاربران شما نباید از این کلید با اطلاع باشند.
نحوه کارکرد کلی
نحوه کلی کارکرد به اینصورت هست که برای ایجاد تصویر امنیتی شما باید درخواستتون رو با استفاده از متود POST به آدرس API ما ارسال کنید. بعد در پاسخ که به صورت JSON هست شما مقادیر لازم رو برای نمایش یک تصویر امنیتی دریافت خواهید کرد.
برای اعتبارسنجی متن وارد شده توسط کاربر نیاز هست تا شما متنی که کاربر وارد کرده رو به همراه بعضی از مقادیری که ما براتون در هنگام ساخت این تصویر امنیتی ارسال کردیم رو مجدد به سمت ما ارسال کنید.
درخواست ایجاد تصویر امنیتی



responseexplanation table
Parameter Description
status if everything goes well in your request, it’s gonna be “success”, otherwise it will be “failed”
message if anything goes wrong, you will get the error message here
adImage the image name for the add (first image that the user sees before the captcha), just the image name
adImageAddress the adImage above with complete and accessible URL
captchaImage real captcha image name, just the image name
captchaImageAddress the captchaImage above with complete and accessible URL
hash just a long string that we need, don’t worry about it
publisherKey we send back your Publisher Key to you again
lang we send back your requested captcha language to you again
customId if you have already sent your request with a customId, we send it back here again so you know what you have requested
اعتبارسنجی کاربر و حروف وارد شده
URL: https://api.adeto.ir/v1/verify
Method: POST
Response Type: JSON
در پاسخ دریافتی از سمت سرور در بالا با استفاده از مقدار status که true/false هست میتونید اعتبار حروف وارد شده توسط کاربر رو بسنجید. بدیهیه که true به معنی معتبر بودن حروف وارد شده توسط کاربر و false به معنی نامعتبر بودن اون هست.
لازم به ذکر هست که هر تصویر امنیتی تولید شده فقط برای 3 دقیقه معتبر هست و بعد از اون expire میشه.
جهت استفاده از مستندات استفاده از REST API در ادتو به منبع مراجعه نمائید