RegistrationRequest

Allows a new player to be created using a username, password display name.

View interactive version here

Request Parameters

Response Parameters

A response to a registration request

Nested types

Player

A nested object that represents a player.

ScriptData

A collection of arbitrary data that can be added to a message via a Cloud Code script.

Error Codes

Code Samples

C#

    using GameSparks.Api;
    using GameSparks.Api.Requests;
    using GameSparks.Api.Responses;
    ...
    new RegistrationRequest()
        .SetDisplayName(displayName)
        .SetPassword(password)
        .SetSegments(segments)
        .SetUserName(userName)
        .Send((response) => {
        string authToken = response.AuthToken; 
        string displayName = response.DisplayName; 
        bool? newPlayer = response.NewPlayer; 
        GSData scriptData = response.ScriptData; 
        var switchSummary = response.SwitchSummary; 
        string userId = response.UserId; 
        });

ActionScript 3

    import com.gamesparks.*;
    import com.gamesparks.api.requests.*;
    import com.gamesparks.api.responses.*;
    import com.gamesparks.api.types.*;
    ...

    gs.getRequestBuilder()
        .createRegistrationRequest()
        .setDisplayName(displayName)
        .setPassword(password)
        .setSegments(segments)
        .setUserName(userName)
        .send(function(response:com.gamesparks.api.responses.RegistrationResponse):void {
        var authToken:String = response.getAuthToken(); 
        var displayName:String = response.getDisplayName(); 
        var newPlayer:Boolean = response.getNewPlayer(); 
        var scriptData:ScriptData = response.getScriptData(); 
        var switchSummary:Player = response.getSwitchSummary(); 
        var userId:String = response.getUserId(); 
        });

Objective-C

    #import "GS.h"
    #import "GSAPI.h"
    ...
    GSRegistrationRequest* request = [[GSRegistrationRequest alloc] init];
    [request setDisplayName:displayName;
    [request setPassword:password;
    [request setSegments:segments;
    [request setUserName:userName;
    [request setCallback:^ (GSRegistrationResponse* response) {
    NSString* authToken = [response getAuthToken]; 
    NSString* displayName = [response getDisplayName]; 
    BOOL newPlayer = [response getNewPlayer]; 
    NSDictionary* scriptData = [response getScriptData]; 
    GSPlayer* switchSummary = [response getSwitchSummary]; 
    NSString* userId = [response getUserId]; 
    }];
    [gs send:request];

C++

    #include <GameSparks/generated/GSRequests.h>
    using namespace GameSparks::Core;
    using namespace GameSparks::Api::Responses;
    using namespace GameSparks::Api::Requests;
    ...

    void RegistrationRequest_Response(GS& gsInstance, const RegistrationResponse& response) {
    gsstl::string authToken = response.getAuthToken(); 
    gsstl::string displayName = response.getDisplayName(); 
    Optional::t_BoolOptional newPlayer = response.getNewPlayer(); 
    GSData scriptData = response.getScriptData(); 
    Types::Player* switchSummary = response.getSwitchSummary(); 
    gsstl::string userId = response.getUserId(); 
    }
    ......

    RegistrationRequest request(gsInstance);
    request.SetDisplayName(displayName)
    request.SetPassword(password)
    request.SetSegments(segments)
    request.SetUserName(userName)
    request.Send(RegistrationRequest_Response);

Java

import com.gamesparks.sdk.api.autogen.GSRequestBuilder.RegistrationRequest;
import com.gamesparks.sdk.api.autogen.GSResponseBuilder.RegistrationResponse;
import com.gamesparks.sdk.api.autogen.GSTypes.*;
import com.gamesparks.sdk.api.GSEventListener;

...
gs.getRequestBuilder().createRegistrationRequest()
    .setDisplayName(displayName)
    .setPassword(password)
    .setSegments(segments)
    .setUserName(userName)
    .send(new GSEventListener<RegistrationResponse>() {
        @Override
        public void onEvent(RegistrationResponse response) {
            String authToken = response.getAuthToken(); 
            String displayName = response.getDisplayName(); 
            Boolean newPlayer = response.getNewPlayer(); 
            GSData scriptData = response.getScriptData(); 
            Player switchSummary = response.getSwitchSummary(); 
            String userId = response.getUserId(); 
        }
    });

Cloud Code

    var request = new SparkRequests.RegistrationRequest();
    request.displayName = ...;
    request.password = ...;
    request.segments = ...;
    request.userName = ...;
    var response = request.Send();

var authToken = response.authToken; 
var displayName = response.displayName; 
var newPlayer = response.newPlayer; 
var scriptData = response.scriptData; 
var switchSummary = response.switchSummary; 
var userId = response.userId;