Tell OneMe Users about your business, and why you need OneMe verification.
Define what information you require from your Users, and explain how it's used.
Use OneMe to verify user info:
All data is sent and recieved as JSON.
All API access is over HTTPS, and accessed from https://api.oneme.com .
OneMe uses the last two query parameters of a query to authenticate the query source.
Therefore, you must include your business id and business Key as the last two query parameters of each query.
Example:
Your Private Credentials are listed below:
Business id = ****
Business Key =
****
* Values hidden until business profile is configured above.
The following is a list of supported https endpoints, their parameters , and their return values.
Example usage:
https://api.oneme.com/inviteUser/__specifiedUserID__/__businessID__/__businessKey__
Method:
GET:
inviteUser is a Get Method used to send a request for information from your business to the specified user.
__specifiedUserID__ :
The unique string that identifies each OneMe User.
Ask the user to paste in their OneMeID , and use this string as the specifiedUserID.
The specifiedUserID denotes which user the request is referring to.
__businessID__ :
The unique string that identifies your business.
Copy your business ID from the Authentication Section above. Use this string in all your
OneMe API requests as the second to last parameter
__businessKey__ :
The secret password used to authenticate your business' request via the OneMe API.
Copy your businessKey from the Authentication Section above. Use this string in all your
OneMe API requests as the last parameter
responseObject:
{
"message": "error message" | undefined
"invitationSent": "true" | undefined
}
Example usage:
https://api.oneme.com/userIsLinked/__specifiedUserID__/__businessID__/__businessKey__
Method:
GET:
userIsLinked is a Get Method used to gauge if a given user has accepted an invitation to share their info with your business.
__specifiedUserID__ :
The unique string that identifies each OneMe User.
Ask the user to paste in their OneMeID , and use this string as the specifiedUserID.
The specifiedUserID denotes which user the request is referring to.
__businessID__ :
The unique string that identifies your business.
Copy your business ID from the Authentication Section above. Use this string in all your
OneMe API requests as the second to last parameter
__businessKey__ :
The secret password used to authenticate your business' request via the OneMe API.
Copy your businessKey from the Authentication Section above. Use this string in all your
OneMe API requests as the last parameter
responseObject:
{
"message": "error message" | undefined
"userIsLinked": "true | false" | undefined
}
Example usage:
https://api.oneme.com/fetchUserInfo/__specifiedUserID__/__businessID__/__businessKey__
Method:
GET:
fetchUserInfo is a Get Method used to retrieve the information about the specified user.
__specifiedUserID__ :
The unique string that identifies each OneMe User.
Ask the user to paste in their OneMeID , and use this string as the specifiedUserID.
The specifiedUserID denotes which user the request is referring to.
__businessID__ :
The unique string that identifies your business.
Copy your business ID from the Authentication Section above. Use this string in all your
OneMe API requests as the second to last parameter
__businessKey__ :
The secret password used to authenticate your business' request via the OneMe API.
Copy your businessKey from the Authentication Section above. Use this string in all your
OneMe API requests as the last parameter
responseObject:
{
"message": "error message" | undefined,
"age": "ageString" | undefined,
"name": "nameSring" | undefined,
"sex": "sexString" | undefined,
"email": "emailString" | undefined,
"phoneNumber": "phoneNumberString" | undefined,
"birthdate": "birthdateString" | undefined,
"credibilityScore" : "credibilityScoreNumber"
}