OCR کنتور برق دیجیتال
خدمت‌دهنده
بازارچه پادیوم
مقدمه
با استفاده از این سرویس شما می توانید اطلاعات کنترل برق خود را شخصا ثبت کنید. این سرویس به شما کمک می کند که بدون نیاز به حضور مامور برق اطلاعات مصرف برق را ارسال نمایید.
پیش از شروع
- URL فراخوانی سرویس ها: https://api.pod.ir/srv/sc/nzh/doServiceCall
- تمامی درخواست ها با متد POST ارسال میشوند.
- Header درخواست:
پارامترهای زیر در Header تمام درخواست ها ثابت است:
| پارامتر | توضیحات |
|---|---|
| _token_ | API token دریافتی از پنل کسب و کاری |
| _token_issuer_ | این پارامتر دارای مقدار ثابت "1" است. |
| Content-Type | application/x-www-form-urlencoded |
- بدنه درخواست:
پارامترهای زیر در بدنه تمام درخواست ها ثابت است:
| پارامتر | توضیحات |
|---|---|
| scProductId | شناسه سرویس در حال استفاده |
| scApiKey | API Key دریافتی برای سرویس مورد نظر از پنل کسب و کاری |
- json Object ها در پارامتری به نام body ارسال میشوند.
- ساختار پاسخ دریافتی پس از فراخوانی سرویس به صورت زیر است که پاسخ دریافتی از endpoint مورد نظر در پارامتر result قرار دارد.
{
"hasError": false/true,
"messageId": 0,
"referenceNumber": "",
"errorCode": 0,
"count": 0,
"ott": "",
"result": {
"result": "response",
"header": {},
"statusCode":
}
}
سرویس OCR کنتورهای برق دیجیتال
- شناسه سرویس : 1077461
این سرویس که به صورت Async می‌باشد ابتدا با فراخوانی سرویس زیر، لینک‌های تصاویر حاوی صفحه کنتور دیجیتال را دریافت می‌نماید. در حقیقت سه لینک از تصاویر صفحه کنتور برق هر کدام برای یک حالت از بار مصرفی، به عنوان ورودی‌های اصلی این سرویس هستند.
- پارامترهای ورودی :
| پارامتر | توضیحات |
|---|---|
| peakLoadImage | آدرس تصویر مصرفی بار بالا |
| meanLoadImage | آدرس تصویر مصرفی بار متوسط |
| minLoadImage | آدرس تصویر مصرفی بارکم |
| userBillId | شماره اشتراک قبض است |
| callBackUrl | آدرس که پاسخ نهایی برای آن ارسال می شود |
| trackerId | شناسه ردیابی می باشد. |
پارامترهای ورودی را براساس اطلاعات اعلام شده وارد میکنیم و سرویس فراخوانی می شود. پس از فراخوانی خروجی تایید دریافت اطلاعات به صورت زیر نمایش داده می شود
{
"hasError": false,
"statusCode": 200,
"message": "Your request was received.",
"packet_id": "eyJ0cmFja2VySWQiOiJrc2pkY25ranNkYyIsImNhbGxCYWNrVXJsIjoiaHR0cDovL2dvb2dsZS5jb20ifQ=="
}
در صورت وجود هرگونه خطایی پارامتر hasError با مقدار true مقداردهی می شود.
پس از مرحله اول (ارسال مقادیر به api) جواب از طریق callback به شما برگشت داده خواهد شد.
پس از تحلیل تصاویر مرحله دوم فراخوانی callBackUrl ارسالی می باشد که در پارامترهای ورودی از شما دریافت شده است
نکته : متد callBackUrl باید post باشد.
- خروجی مرحله دوم
{
"result": {
"minLoadConsumption": "01294524",
"meanLoadConsumption": "01294524",
"peakLoadConsumption": "01294524"
},
"hasError": false,
"statusCode": 200,
"packetId": "eyJ0cmFja2VySWQiOiJrc2pkY25ranNkYyIsImNhbGxCYWNrVXJsIjoiaHR0cDovL2dvb2dsZS5jb20ifQ==",
"user_subscription_number": "35163516516dscs"
}
در خروجی فوق minLoadConsumption، meanLoadConsumption، peakLoadConsumption به ترتیب نتیجه OCR تصویر مصرفی بارکم، OCR تصویر مصرفی بار متوسط، و OCR تصویر مصرفی بار بالا می‌باشد
در صورت وجود مشکل پارامتر hasError با مقدار true پر می شود
