Description |
Gets information about the user. |
URL |
/connect/user |
Parameters |
api_key |
string |
The public API key of the user. (Details:
Authentication
) |
timestamp |
string |
The current UTC timestamp (seconds from 1/1/1970 until UTC now). (Details:
Authentication
) |
api_sign |
string |
The timestamp encoded with HMAC SHA1 in use of the private key. (Details:
Authentication
) |
Example call
$url = 'https://webapp.nativy.com/connect/user';
$api_key = 'iQU5lBuEjYFMx2I92o>bp*u02K^Bmie3d}pg-pU^MZ&%mobYM&x7asY+21u7PHEh';
$private_key = '4i2j_F|=lUqNmxPMxtWsX-veXJ)i+w(hq[_J&(r{Pn[jyT&)xt*UapyK%B_jv{tP';
$timestamp = gmdate('U');
$hmac = hash_hmac('sha1', $timestamp, $private_key);
$url = $url
. '?api_key=' . urlencode($api_key)
. '&api_sign=' . urlencode($hmac)
. '×tamp=' . urlencode($timestamp);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo ($response);
Return values
gender |
string |
The gender of the user (use "F" for female and "M" for male). |
firstname |
string |
The first name of the user. |
lastname |
string |
The last name of the user. |
email |
string |
The email address of the user. |
company |
string |
The company name of the user, in case the user orders translations for his company. |
street |
string |
The street of the user. This will be used as the default street for invoices, you may post a different address when posting an order to nativy. |
zip |
string |
The zip (postal code) of the user. This will be used as the default zip for invoices, you may post a different address when posting an order to nativy. |
city |
string |
The city of the user. This will be used as the default city for invoices, you may post a different address when posting an order to nativy. |
country_code |
string |
The 2 letter long country code of the user's country in ISO 3166-1-alpha-2 format. This will be used as the default country for invoices, you may post a different address when posting an order to nativy. |
password |
string |
The password for the user's nativy account. Minimum length must be 6 characters. |
vatnumber |
string |
The vat number of the user's company. (Details: http://en.wikipedia.org/wiki/VAT_identification_number) |
phone |
string |
The phone number of the user. |
degree |
string |
The degree of the user (e.g. Dr.). |
user_picture_link |
string |
The account image the user uses on nativy.com. |
payment_modes |
array |
The payment options the user has as a string array. Can be one or more of the following payment modes:
-
credit_card
If the user chooses to pay by credit card, you must redirect your user to the payment_link (in an iframe or a popup window) after the user has chosen a translator offer. You get the payment_link for each offer after calling /order POST.
-
bank_transfer
The user is allowed to pay via bank transfer. Call /order/{orderid}/{rank} PUT to choose an offer. The user gets the nativy bank account details on his invoice which can be downloaded with /order/{orderid}/invoice GET
|
Example return values
{
"api_key":null,
"api_private_key":null,
"api_public_key":null,
"api_sign":null,
"city":"Wien",
"company":"nativy GmbH",
"country_code":"AT",
"degree":"Ing.",
"email":"testuser_ak@nativy.com",
"firstname":"Anton",
"gender":"M",
"lastname":"Kerschbaummayr",
"nativy_partner_api_key":null,
"nativy_partner_api_sign":null,
"nativy_partner_timestamp":null,
"payment_modes":["credit_card","bank_transfer"],
"phone":"+43 699 11220883",
"street":"Novaragasse 38A\/9",
"timestamp":null,
"user_picture_link":"http:\/\/test.nativy.com:55208\/ShowImage.ashx?PersonId=8e2158ad-98cf-4f50-b6d4-6ae85ee7c398&Size=PictureFileSmall",
"vatnumber":"ATU65800617",
"zip":"1020"
}