Use API_GetUserInfo to get the username and user ID associated with an email address used for Quick Base sign in. You invoke this call on db/main. You can use this call to grant a user access rights to your application and then invite that user to your application. This call is typically made to return the Quick Base user ID for a user whose email address you know, in preparation for subsequent calls to API_AddUserToRole (grant access rights) and API_SendInvitation, both of which require the user ID.
The user email that you specify must be recognized in Quick Base. (For users who aren’t registered in Quick Base yet, use the alternative call API_ProvisionUser.)
For anonymous users, this call returns:
If the anonymous user passes in an email parameter, the email will be passed back in the response.
If you don’t supply an email parameter, the ticket parameter will be used to determine the current user, which means the current user ID, name, and email are returned.
A valid authentication ticket.
The authentication ticket is returned via the API_Authenticate call.
The user token is an alternative means of authentication, used for API access. User tokens cannot be used to access the Quick Base UI.
yes, one of:
A valid application token
yes, if the application requires application tokens
Supply the email address (as registered with Quick Base) of the user whose information you want. You can also supply the user’s user name.
If you don’t supply this parameter, the call returns the user info of the user to whom the ticket was issued (you).
For anonymous users, the email parameter is ignored.
A string value that you want returned. It will not be handled by Quick Base but it will be returned in the response.
Echoes the originating request, for example, API_AddField.
Identifies the error code, if any. (See the Error Codes appendix for a list of possible error codes.)
0 indicates that no error was encountered.
Text that explains the error code.
"No error" indicates that no error was encountered.
The ticket needed for application access.
The returned user aggregate. This aggregate always contains the user ID attribute and the user name. The user aggregate also contains the user login if the email parameter was NOT specified in the request. The login will be any of the following:
The aggregate is structured as follows:
Optional. Contains any udata value supplied in the request.
where target_domain is the domain against which you are invoking this call, for example, quickbase.com. Read about this notation.
<?xml version="1.0" ?>
Did this help you? Give us a rating:
© 1999-2020 QuickBase, Inc. All rights reserved. Legal Notices.