4009
Want to tighten your application’s security with 2 factor authentication but don’t know how? Worry on how to retrieve your customer’s number? Ginota Genuine SMS API is all you need.
Before get started with our guide, create a Ginota Account with us now!
Retrieves contact number via Ginota Genuine SMS API
Retrieving a MSISDN via Ginota Genuine SMS API is easy and simple. The following basic items are what you need:
- Your Ginota Account
- Your preferred web browser
- Your API Credentials (can be obtained from Dashboard > Messaging after login to Ginota portal)
Quick Test using Your Genuine SMS API URL
Once login to Ginota portal, navigate to Message, you can obtain the Genuine SMS API URL (Next to your Restful API URL):
This is a sample Ginota Genuine SMS API request which sends an email to the requested email address of the recipient.
Once email is received, recipient is required to click on the ‘Register mobile number’ link and user will be prompt with a mobile number registration page on a browser.
A valid mobile number is required to proceed with the next verification step where Ginota will be sending a One Time Password to it.
Recipient shall key in the Verification Code to have his/her mobile number authorized and at the same time saving the MSISDN into the database.
To perform a quick test with Ginota Genuine SMS API, you may copy and paste the API URL into the address box of your preferred browser and navigate. Once navigate, you should receive an email in seconds.
Form Your Own Ginota Genuine SMS API Request
You may create your own Ginota Genuine SMS API Request with all the items required.
- Firstly, copy your Restful API URL into the address box of your browser:
| https://www.ginota.com/gemp/otp/discoverMobile?apiKey=14RN7jFlDRLDv8xD4lNKWw%2BUttzoNVyA&apiSecret=%24b74N0r1u%24&email=<Recipient_Email_Address>&sName=<Recipient_Name> |
Once the Genuine SMS API URL is formed with your API credentials appended, you may start replacing the following parameters:
- Replace <Recipient_Email_Address> with any valid email address of your friends or family.
[email protected] - Replace <Recipient_Name> with any name of your friends or family. The recipient name must be URL-encoded. You may make use of this online URL encoder by providing your message body accordingly and click encode. Copy the encoded value and replace <Recipient_Name>:
| URL Encoded Sample | Language | Expected Text Received |
|---|---|---|
| sName=Jessica+Anderson | English | Jessica Anderson |
| content=%e4%b8%ad%e6%96%87%e4%bf%a1%e6%81%af | Chinese | 中文信息 |
| content=%e3%81%93%e3%82%93%e3%81%ab%e3%81%a1%e3%81%af | Japanese | こんにちは |
This is how a standard Ginota Genuine SMS API request shall looks like:
| https://www.ginota.com/gemp/otp/discoverMobile?apiKey=sKhUimwdncuaO%2Bjv4FiCF6WzBsn%2BqMIZ&apiSecret=M%40%24%40WNngwv&email=[email protected]&sName=Jessica+Anderson |
Lastly, simply copy and paste this URL on to your browser and navigate there to send it out. The recipient should receive an email immediately!
Learn more
We are working hard to make it easier for developers to create simple and reliable communication (Genuine SMS API) used for their applications. Check out the following resources to enjoy all the capabilities of Ginota:
- Documentations: Access our documentation resources to learn how to build simple apps for voice and SMS.
- Speak with our experts: Create a support ticket or talk to us on Skype.
