4.1 Create User (创建帐户)

Description (说明)

This API call is used to create a player account.
本功能用于建立玩家账户。

URL (网址)

https://{host}/api/create_user

Request Method

POST

Request Parameters (请求参数)

Field (栏位)	Type (型态)	Required (必要)	Description (说明)
agentId	String	Y	Agent ID <= 50 characters 代理帐号
userId	String	Y	A unique user id (only allow lower case a~z and 0~9) BY WEBSITE <= 50 characters 网站上唯一的用户ID（仅允许小写a~z和0~9）
balance	String	N	Initial balance in the account.(By default is 0) decimal places <= 4 账户初始额度(预设为 0)
freeCredit	String	N	Initial freeCredit in the account.(By default is 0) decimal places <= 4 泥码初始额度(预设为 0) if your company has not enabled the free credit function, then please ignore this attribute. 若贵司未开启泥码功能，则请忽略此属性

{
  "agentId": "hrgag",
  "userId": "hrgpl0001",
  "balance": "100000.0",
  "freeCredit": "100.0"
}

Return Result (返回结果)

Field (栏位)	Type (型态)	Description (说明)
code	String	Status Code fixed 4 characters 状态码 Please refer to 5.4 Status Code for details. 详情请参考 5.4 状态代码
data	Object
agentId	String	Agent ID <= 50 characters 代理帐号
userId	String	User ID <= 50 characters 玩家帐号
balance	String	Balance decimal places <= 4 帐户余额
freeCredit	String	Free credit decimal places <= 4 泥码余额 if your company has not enabled the free credit function, then please ignore this attribute. 若贵司未开启泥码功能，则请忽略此属性

{
  "code": "0000",
  "data": {
    "agentId": "hrgag",
    "userId": "hrgpl0001",
    "balance": "100000.0",
    "freeCredit": "100.0"
  }
}

Sample Request For Each Language (各语言请求范例)

Java - OkHttp

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"agentId\":\"hrgag\",\"userId\":\"hrgpl0001\",\"balance\":\"100000.0\",\"freeCredit\":\"100.0\"}");
Request request = new Request.Builder()
  .url("https://{host}/api/create_user")
  .method("POST", body)
  .addHeader("Authorization", "Basic TWpNQ0JSM1NFYnBrYXdSNTpNak1DQlIzU0VicGthd1I1")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

var client = new RestClient("https://{host}/api/create_user");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Basic TWpNQ0JSM1NFYnBrYXdSNTpNak1DQlIzU0VicGthd1I1");
request.AddHeader("Content-Type", "application/json");
var body = @"{\"agentId\":\"hrgag\",\"userId\":\"hrgpl0001\",\"balance\":\"100000.0\",\"freeCredit\":\"100.0\"}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

var myHeaders = new Headers();
myHeaders.append("Authorization", "Basic TWpNQ0JSM1NFYnBrYXdSNTpNak1DQlIzU0VicGthd1I1");
myHeaders.append("Content-Type", "application/json");

var raw = "{\"agentId\":\"hrgag\",\"userId\":\"hrgpl0001\",\"balance\":\"100000.0\",\"freeCredit\":\"100.0\"}";

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://{host}/api/create_user", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import http.client
import json

conn = http.client.HTTPSConnection("{host}")
payload = "{\"agentId\":\"hrgag\",\"userId\":\"hrgpl0001\",\"balance\":\"100000.0\",\"freeCredit\":\"100.0\"}"
headers = {
  'Authorization': 'Basic TWpNQ0JSM1NFYnBrYXdSNTpNak1DQlIzU0VicGthd1I1',
  'Content-Type': 'application/json'
}
conn.request("POST", "https://{host}/api/create_user", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://{host}/api/create_user"
  method := "POST"

  payload := "{\"agentId\":\"hrgag\",\"userId\":\"hrgpl0001\",\"balance\":\"100000.0\",\"freeCredit\":\"100.0\"}"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Basic TWpNQ0JSM1NFYnBrYXdSNTpNak1DQlIzU0VicGthd1I1")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://{host}/api/create_user');
$request->setMethod(HTTP_Request2::METHOD_POST);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Authorization' => 'Basic TWpNQ0JSM1NFYnBrYXdSNTpNak1DQlIzU0VicGthd1I1',
  'Content-Type' => 'application/json'
));
$request->setBody("{\"agentId\":\"hrgag\",\"userId\":\"hrgpl0001\",\"balance\":\"100000.0\",\"freeCredit\":\"100.0\"}");
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}