search

camaraproject / DeviceStatus

Repository to describe, develop, document and test the Device Status API family
Apache License 2.0
11 stars 31 forks source link

Check the Overlap between DeviceStatus and ShutdownServiceStatus #167

Open chinaunicomyangfan opened 3 weeks ago

chinaunicomyangfan commented 3 weeks ago

Problem description

Based on the decision of the APIBacklog meeting, we need to discuss whether there is any overlap between DeviceStatus and ShutdownServiceStatus.

Introduction ShutdownServiceStatus API allows users to obtain the current shutdown status of a phone number, including voice/SMS incoming shutdown, voice/SMS outgoing shutdown, and data service shutdown. This API queries the business shutdown status of the number, for example, due to overdue payments.

Use Case Payment System and Risk Management: In scenarios where payment or identity verification relies on phone numbers, such as e-commerce platforms or financial service providers, this API can be used to verify whether user accounts are functioning properly. This helps to reduce fraud and payment risks, ensuring that only normal accounts can conduct transactions.

Opinion I think the main difference between ShutdownServiceStatus and device status is that DeviceStatus obtains the device's connection status, while ShutdownServicestatus obtains the business status of the phone number. When a user turns off the phone, the connection status is closed, but the business status is open.

akoshunyadi commented 2 weeks ago

@chinaunicomyangfan DeviceStatus API currently offers the check of the connectivity status, which can be not-connected. If I understand it correctly, the new API should check whether the SIM card has an active subscription e.g. for data, right?

ShutdownServiceStatus sounds little confusing, something like SubscriptionStatus would be clearer.

chinaunicomyangfan commented 2 weeks ago

@akoshunyadi Yes,I think you are right.ShutdownServiceStatus is used to describe situations where phone numbers are overdue, unusable, or cancelled. Different countries have different descriptions as well.If SubscriptionStatus is more general and clear, we can consider modifying the API name

sachinvodafone commented 2 weeks ago

"DeviceSubscriptionStatus" could be another option in this case.

chinaunicomyangfan commented 2 weeks ago

"DeviceSubscriptionStatus" could be another option in this case.

@sachinvodafone Thank you for your suggestion.

ShutingQing commented 1 week ago

Subscription is accurate. Suggest to consider subscription as an option in naming. However, should this be the business status of phone number, instead of device? I think it's a good option to name it as SubscriptionStatus or ServiceSubscriptionStatus. @chinaunicomyangfan