(Delphi DLL) GeoOp - Create a New User

Create a new GeoOp user.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, OAuth2, Rest, JsonObject;

...

procedure TForm1.Button1Click(Sender: TObject);
var
jsonToken: HCkJsonObject;
success: Boolean;
oauth2: HCkOAuth2;
rest: HCkRest;
bAutoReconnect: Boolean;
jsonUser: HCkJsonObject;
responseBody: PWideChar;
json: HCkJsonObject;

begin
// 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 := CkJsonObject_Create();
success := CkJsonObject_LoadFile(jsonToken,'qa_data/tokens/geoop.json');

// This example assumes we previously obtained an access token
oauth2 := CkOAuth2_Create();
CkOAuth2_putAccessToken(oauth2,CkJsonObject__stringOf(jsonToken,'access_token'));

rest := CkRest_Create();

// 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 := True;
success := CkRest_Connect(rest,'api.geoop.com',443,True,bAutoReconnect);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

// Provide the authentication credentials (i.e. the access token)
CkRest_SetAuthOAuth2(rest,oauth2);

// Set the X-Version header.
CkRest_AddHeader(rest,'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 := CkJsonObject_Create();
CkJsonObject_UpdateInt(jsonUser,'users[0].account.id',39409);
CkJsonObject_UpdateString(jsonUser,'users[0].firstName','Geoff');
CkJsonObject_UpdateString(jsonUser,'users[0].lastName','Wirtz');
CkJsonObject_UpdateString(jsonUser,'users[0].companyName','Sample Company');
CkJsonObject_UpdateString(jsonUser,'users[0].phone','+12349282001');
CkJsonObject_UpdateString(jsonUser,'users[0].mobile','+12349332744');
CkJsonObject_UpdateString(jsonUser,'users[0].email','gwirtz@example2.com');
CkJsonObject_UpdateString(jsonUser,'users[0].login','gwirtz_sample2');
CkJsonObject_UpdateString(jsonUser,'users[0].newPassword','pa$$wordz');
CkJsonObject_UpdateString(jsonUser,'users[0].newPasswordConfirm','pa$$wordz');

// Examine the JSON we're about to send...
CkJsonObject_putEmitCompact(jsonUser,False);
Memo1.Lines.Add(CkJsonObject__emit(jsonUser));

CkRest_AddHeader(rest,'Content-Type','application/json');

CkJsonObject_putEmitCompact(jsonUser,True);
responseBody := CkRest__fullRequestString(rest,'POST','/users',CkJsonObject__emit(jsonUser));
if (CkRest_getLastMethodSuccess(rest) <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

// If the response status code did not indicate success, then see what happened..
if (CkRest_getResponseStatusCode(rest) <> 200) then
  begin
    Memo1.Lines.Add('Request Header: ');
    Memo1.Lines.Add(CkRest__lastRequestHeader(rest));
    Memo1.Lines.Add('----');
    Memo1.Lines.Add('Response StatusCode = ' + IntToStr(CkRest_getResponseStatusCode(rest)));
    Memo1.Lines.Add('Response StatusLine: ' + CkRest__responseStatusText(rest));
    Memo1.Lines.Add('Response Header:');
    Memo1.Lines.Add(CkRest__responseHeader(rest));
    Memo1.Lines.Add(responseBody);
    Exit;
  end;

json := CkJsonObject_Create();
CkJsonObject_putEmitCompact(json,False);
CkJsonObject_Load(json,responseBody);
// Show the full JSON response..
Memo1.Lines.Add(CkJsonObject__emit(json));

// 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": [
//     ]
//   }
// }
// 

CkJsonObject_Dispose(jsonToken);
CkOAuth2_Dispose(oauth2);
CkRest_Dispose(rest);
CkJsonObject_Dispose(jsonUser);
CkJsonObject_Dispose(json);

end;