Betting.WebApi

<back to all web services

RegisterUserAccount

Requires Authentication
The following routes are available for this service:
POST/cmd/users/register
const std = @import("std");

pub const LoginCredentials = struct {
    username: ?[]const u8 = null,
    password: ?[]const u8 = null,
};

pub const Name = struct {
    first: ?[]const u8 = null,
    last: ?[]const u8 = null,
    full: ?[]const u8 = null,
};

pub const Ref = struct {
    id: ?[]const u8 = null,
    val: ?[]const u8 = null,
};

pub const GPSCoordinates = struct {
    lat: f64 = 0,
    lng: f64 = 0,
};

pub const Address = struct {
    street: ?[]const u8 = null,
    city: ?[]const u8 = null,
    state: ?[]const u8 = null,
    postalCode: ?[]const u8 = null,
    country: ?Ref = null,
    gps: ?GPSCoordinates = null,
    data: ?RecordDictionary = null,
};

pub const ContactInfo = struct {
    phone: ?[]const u8 = null,
    email: ?[]const u8 = null,
};

pub const Person = struct {
    name: ?Name = null,
    address: ?Address = null,
    dateOfBirth: ?[]const u8 = null,
    contactInfo: ?ContactInfo = null,
};

pub const AvatarImage = struct {
    base64: ?[]const u8 = null,
    tag: ?[]const u8 = null,
};

pub const NewUserDTO = struct {
    externalUserId: ?[]const u8 = null,
    credentials: ?LoginCredentials = null,
    person: ?Person = null,
    roles: ?RecordList = null,
    avatar: ?AvatarImage = null,
};

pub const RegisterUserAccount = struct {
    id: ?[]const u8 = null,
    newUserDTO: ?NewUserDTO = null,
};

pub fn RecordDictionary(comptime TKey: type, comptime TVal: type) type {
    _ = TKey;
    _ = TVal;
    return struct {};
}

pub fn RecordList(comptime T: type) type {
    _ = T;
    return struct {
        pub const ss_collection = "items";

        items: []T = &.{},
    };

Zig RegisterUserAccount DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /cmd/users/register HTTP/1.1 
Host: api.bettor.webhop.biz 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	id: String,
	newUserDTO: 
	{
		externalUserId: String,
		credentials: 
		{
			username: String,
			password: String
		},
		person: 
		{
			name: 
			{
				first: String,
				last: String,
				full: String String
			},
			address: 
			{
				street: String,
				city: String,
				state: String,
				postalCode: String,
				country: 
				{
					id: String,
					val: String
				},
				gps: 
				{
					lat: 0,
					lng: 0
				},
				data: 
				{
					String: String
				}
			},
			dateOfBirth: 0001-01-01,
			contactInfo: 
			{
				phone: String,
				email: String
			}
		},
		roles: 
		[
			String
		],
		avatar: 
		{
			base64: String,
			tag: String
		}
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	errorCode: String,
	message: String,
	stackTrace: String,
	errors: 
	[
		{
			errorCode: String,
			fieldName: String,
			message: String,
			meta: 
			{
				String: String
			}
		}
	],
	meta: 
	{
		String: String
	}
}