(Perl) GeoOp - Create a New User

Create a new GeoOp user.

Chilkat Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# This example also assumes an OAuth2 access token was previously fetched.
# and saved in a JSON file.  

# First get our previously obtained access token.
# {"access_token":"e6dqdG....mzjpT04w==","token_type":"Bearer","expires_in":2592000,"owner_id":999236}
$jsonToken = chilkat::CkJsonObject->new();
$success = $jsonToken->LoadFile("qa_data/tokens/geoop.json");

# This example assumes we previously obtained an access token
$oauth2 = chilkat::CkOAuth2->new();
$oauth2->put_AccessToken($jsonToken->stringOf("access_token"));

$rest = chilkat::CkRest->new();

# Connect to GeoOp..
# Note: The same REST object, once connected, can be used for many requests.
# The bAutoReconnect argument allows it to automatically reconnect as required for any subsequent request.

$bAutoReconnect = 1;
$success = $rest->Connect("api.geoop.com",443,1,$bAutoReconnect);
if ($success != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

# Provide the authentication credentials (i.e. the access token)
$rest->SetAuthOAuth2($oauth2);

# Set the X-Version header.
$rest->AddHeader("X-Version","1.0");

# To create a new user, we must build and send the following JSON:
# {
#     "users": [
#         {
#             "account": {
#                 "id": 39409    <--- This account ID must be one that already exists.
#             },
#             "firstName": "Geoff",
#             "lastName": "Wirtz",
#             "companyName": "Sample Company",
#             "phone": "+12349282001",
#             "mobile": "+12349332744",
#             "email": "gwirtz@example2.com",
#             "login": "gwirtz_sample2",
#             "newPassword": "pa$$wordz",
#             "newPasswordConfirm": "pa$$wordz"
#         }
#     ]
# }

$jsonUser = chilkat::CkJsonObject->new();
$jsonUser->UpdateInt("users[0].account.id",39409);
$jsonUser->UpdateString("users[0].firstName","Geoff");
$jsonUser->UpdateString("users[0].lastName","Wirtz");
$jsonUser->UpdateString("users[0].companyName","Sample Company");
$jsonUser->UpdateString("users[0].phone","+12349282001");
$jsonUser->UpdateString("users[0].mobile","+12349332744");
$jsonUser->UpdateString("users[0].email",'gwirtz@example2.com');
$jsonUser->UpdateString("users[0].login","gwirtz_sample2");
$jsonUser->UpdateString("users[0].newPassword","pa$$wordz");
$jsonUser->UpdateString("users[0].newPasswordConfirm","pa$$wordz");

# Examine the JSON we're about to send...
$jsonUser->put_EmitCompact(0);
print $jsonUser->emit() . "\r\n";

$rest->AddHeader("Content-Type","application/json");

$jsonUser->put_EmitCompact(1);
$responseBody = $rest->fullRequestString("POST","/users",$jsonUser->emit());
if ($rest->get_LastMethodSuccess() != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

# If the response status code did not indicate success, then see what happened..
if ($rest->get_ResponseStatusCode() != 200) {
    print "Request Header: " . "\r\n";
    print $rest->lastRequestHeader() . "\r\n";
    print "----" . "\r\n";
    print "Response StatusCode = " . $rest->get_ResponseStatusCode() . "\r\n";
    print "Response StatusLine: " . $rest->responseStatusText() . "\r\n";
    print "Response Header:" . "\r\n";
    print $rest->responseHeader() . "\r\n";
    print $responseBody . "\r\n";
    exit;
}

$json = chilkat::CkJsonObject->new();
$json->put_EmitCompact(0);
$json->Load($responseBody);
# Show the full JSON response..
print $json->emit() . "\r\n";

# The success JSON looks like this:
# {
#   "result": "success",
#   "users": [
#     {
#       "id": 984244,
#       "firstName": "Geoff",
#       "lastName": "Wirtz",
#       "companyName": "Sample Company",
#       "email": "gwirtz@example2.com",
#       "phone": "+12349282001",
#       "mobile": "+12349332744",
#       "hourlyRate": 0,
#       "active": 1,
#       "deleted": false,
#       "colour": "#000000",
#       "created": "2016-10-26T18:03:59+00:00",
#       "modified": "2016-10-26T18:03:59+00:00",
#       "isAssignable": true,
#       "avatarUrl": "https:\/\/www.geoop.com\/images\/mobithumb_984244.jpg",
#       "role": {
#         "id": 2
#       },
#       "account": {
#         "id": 39409
#       },
#       "status": {}
#     }
#   ],
#   "metadata": {
#     "receivedItemsCount": 1,
#     "validItems": [
#       0
#     ],
#     "invalidItems": [
#     ]
#   }
# }
#