ProPTT2 Developers

Get Server URL

Get server's URL for company.

1) request

Method	POST
URL	https://{CloudURL or YourServer's URL}/openapi/1/server

Body :

field name	type	description	option
id	string	company owner's id(email)	mandatory
hid	number	source host id(1~10). Cutomer can select the value. Customer can have 10 hosts to connect OpenAPI.	mandatory

Example :

{
    "id" : "owner@company.com",
    "hid" : 1
}

2) response

field name	type	description	option
ServerURL	string	API server's URL	mandatory
Rand	string	API server's Random number	mandatory

Available error code :

code	description
403	Request forbidden. parameter invalid

Example :

{
    "ServerURL": "https://aa.aa.com"
    "Rand": "452673a34b"
}

Get Session Key

After "/server" call, you have to call this just one time. Server's Random number will be reset.

1) request

Method	POST
URL	{ServerURL}/openapi/1/auth

Body :

field name	type	description	option
id	string	company owner's id(ProPTT2 ID)	mandatory
hid	number	source host id(1~10) in server command.	mandatory
authKey	string	Lowercase(Base16(Sha512(Rand + '-' + company's interaction key)))	mandatory

If Rand=12345678, interacionKey="bb00cc"
Lowercase(Base16(Sha512("12345678-bb00cc"))) 
= "7aeaef20455f726d8aa464c4fd57f670657dfea039585e7a6a1e5889537956a43f3a4600ee7eef
305f4f7e309792062cd01be49f6c0438007774347477feb558"

[ Java sample code ]
public static String encryptSha512(String str) {
	String eip;  
	byte[] bip; 
	String resultStr = ""; 
	try { 
		MessageDigest sha512 = MessageDigest.getInstance("SHA-512"); 
		
		bip = sha512.digest(str.getBytes());
		for (int i=0; i < bip.length; i++) { 
			eip = "" + Integer.toHexString((int)bip[i] & 0x000000ff); 
			if (eip.length() < 2) eip = "0" + eip; 
			resultStr = resultStr + eip; 
		} 
	} catch(Exception e) { 
		e.printStackTrace(); 
	} 
	return resultStr;
}

String myAuthKey = encryptSha512("12345678-bb00cc");

[ PHP sample code ]
$authKey = strtolower(hash("sha512", "12345678-bb00cc"));

Example :

{
    "id": "abc@proptt2.com",
    "hid" : 1,
    "authKey": "452673a34b"
}

2) response

field name	type	description	option
sessionkey	string	session key. In server 3.1.2, this sesstion has 10 minute timeout. You can refer to the keepalive API.	mandatory

Available error code :

code	description
401	Authentication failure
403	Request forbidden. parameter invalid

Example :

{
    "sessionkey":"a34b56c21"
}

Keep Alive

This is for keeping session key. Please call this every 3 minute to keet seesion time.

1) request

Method	GET
Required	Server 3.1.2 ~
URL	{ServerURL}/openapi/1/keepalive?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
401	Authentication failure
403	Request forbidden. parameter invalid

Get Channel List

1) request

Method	GET
URL	{ServerURL}/openapi/1/channels?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name		type	description	option
channels			channel list
	id	number	channel's ID	mandatory
	no	string	channel's No	mandatory
	name	string	channel's name	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "channels":[
        {
            "id" : 1,
            "no" : "34",
            "name" : "abc"
        },{
            "id" : 2,
            "no" : "23",
            "name" : "efg"
        }
    ]
}

Create Channel

1) request

Method	POST
URL	{ServerURL}/openapi/1/channels?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
no	string	channel's No	mandatory
name	string	channel's name	mandatory
description	string	channel's description
notification	string	channel's notification
TOT	number	Time Over Time(Max 600)	default 30
recordable	boolean	Is recordable in client-side?	default true
encrypted	boolean	Is encrypted channel (Required Server 2.2.8 ~)	default false
shareLocations	boolean	Is location shared channel (Required Server 3.3.0 ~)	default false
status	number	10:Normal, 80:Stopped (Required Server 5.1.0 ~)

Example :

{
    "no" : 123,
    "name": "abc",
    "description":"this is a good channel."
    "notification":"welcome.",
    "TOT":20,
    "recordable":true,
    "encrypted":false
}

2) response

field name	type	description	option
id	number	created channel's ID	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "id":12
}

Get Channel

1) request

Method	GET
URL	{ServerURL}/openapi/1/channels/{cid}?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to get
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
no	string	channel's No	mandatory
name	string	channel's name	mandatory
description	string	channel's description	mandatory
notification	string	channel's notification	mandatory
TOT	number	Time Over Time	mandatory
recordable	boolean	Is recordable?	mandatory
encrypted	boolean	Is encrypted (Required Server 2.2.8 ~)	mandatory
shareLocations	boolean	Is location shared channel (Required Server 3.3.0 ~)
leader	number	leader's user id	mandatory
status	number	10:Normal, 80:Stopped (Required Server 5.1.0 ~)
modified	boolean	Is modified (Required Server 7.1.3 ~)

Available error code :

code	description
500	Internal error

Example :

{
    "no" : 123,
    "name":"abc",
    "description":"this is a good channel."
    "notification":"welcome.",
    "TOT":20,
    "recordable":true,
    "encrypted":true,
    "leader":5
}

Update Channel

1) request

Method	PUT
URL	{ServerURL}/openapi/1/channels/{cid}?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to update
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
name	string	channel's name	mandatory
description	string	channel's description
notification	string	channel's notification
TOT	number	Time Over Time(Max 600)	default 30
status	number	10:Normal, 80:Stopped (Required Server 5.1.0 ~)

Example :

{
    "name": "abc",
    "description":"this is a good channel.",
    "Notification":"welcome.",
}

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Delete Channel

1) request

Method	DELETE
URL	{ServerURL}/openapi/1/channels/{cid}?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to delete
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Purge All Channels

All channel information of Relay servers will be deleted. Please note it could not be safe if it is called on service.

1) request (Required Server 7.1.3 ~)

Method	POST
URL	{ServerURL}/openapi/1/channels/purgeAll?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Link User To Channel

1) request

Method	POST
URL	{ServerURL}/openapi/1/channels/{cid}/users/{uid}?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to be link
uid	user's ID to be linked
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
role	number	user's role, 10:normal,20:Receiver,90:Operator, (Required Server 3.2.0 ~)	default 10

3) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
409	Conflict. Already linked user
500	Internal error

Example :

{
    "code":"200"
}

Get Users Of Channel

1) request

Method	GET
URL	{ServerURL}/openapi/1/channels/{cid}/users?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to get
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name		type	description	option
users			user list	mandatory
	id	number	user's ID	mandatory
	strId	string	user's ProPTT2 ID(email)	mandatory
	name	string	user's name	mandatory
	type	number	user's type. 20: ProGate, 21: SIP device, 50: Normal, 70: Channel Leader, 80: Dispatcher, 90:Manager (Required Server 3.0.1 ~)	mandatory
	role	number	user's role, 10:normal,20:Receiver,90:Operator, (Required Server 3.2.0 ~)	default 10
	level	number	user's level id(Required Server 5.1.0 ~)
	phoneNumber	string	user's phoneNumber(Required Server 5.1.0 ~)
	email	string	user's email(Required Server 5.1.0 ~)

Available error code :

code	description
500	Internal error

Example :

{
    "users":[
        {
            "id" : 1,
            "strId" : "abc@company.ptt",
            "name" : "abc",
            "type" : 50,
            "role" : 10
        },{
            "id" : 2,
            "strId" : "efg@company.ptt",
            "name" : "efg",
            "type" : 50,
            "role" : 20
        }
    ]
}

Update User Of Channel

1) request

Method	PUT
Required	Server 5.1.x ~
URL	{ServerURL}/openapi/1/channels/{cid}/users/{uid}?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to be updated
uid	user's ID to be updated
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
role	number	user's role, 10:normal,20:Receiver,90:Operator	default 10

Example :

{
    "role": 10
}

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Unlink User To Channel

1) request

Method	DELETE
URL	{ServerURL}/openapi/1/channels/{cid}/users/{uid}?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to be unlink
uid	user's ID to be unlinked
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Get Records Of Channel(Server 2.2.8~)

1) request

Method	GET
URL	{ServerURL}/openapi/1/channels/{cid}/records?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to get
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey
start	start record index. 0 based
pageSize	size to get

Body : Nothing

2) response

field name		type	description	option
records			record list	mandatory
	id	number	record's ID	mandatory
	type	number	10: AudioPTT, 20:VideoPTT, 31:VideoShared	mandatory
	status	number	10: Normal	mandatory
	fileSize	number	file size(KB)	mandatory
	ownerId	number	owner id	mandatory
	ownerName	string	owner's name	mandatory
	createDate	string	created date	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "records":[
        {
            "id" : 1,
            "type" : 10,
            "status" : 10,
            "fileSize" : 32,
            "ownerId" : 1,
            "ownerName" : "owner name",
            "createDate" : "2017-11-02 04:29:02"
        },{
            "id" : 2,
            "type" : 10,
            "status" : 20,
            "fileSize" : 40,
            "ownerId" : 1,
            "ownerName" : "owner name",
            "createDate" : "2017-11-02 04:45:02"
        }
    ]
}

Send a sync event to Channel

1) request

Method	POST
Required	Server 5.1.x ~
URL	{ServerURL}/openapi/1/channels/{cid}/sync?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to be synced
id	company owner's id(email). It is a sender.
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Send a message to Channel

1) request

Method	POST
Required	Server 1.2.x ~
URL	{ServerURL}/openapi/1/channels/{cid}/sendMessage?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to get
id	company owner's id(email). It is a sender.
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
messageId	number	message's id	mandatory
messageContent	string	message to be sent. messageContent=Base64(message)

Example :

{
    "messageId": 1,
    "messageContent":"SGVsbG8="
}

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Send a SOS to Channel

1) request

Method	POST
Required	Server 2.0.x ~
URL	{ServerURL}/openapi/1/channels/{cid}/sendSOS?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to get
id	company owner's id(email). It is a sender.
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Send an alert to Channel

1) request

Method	POST
Required	Server 2.0.x ~
URL	{ServerURL}/openapi/1/channels/{cid}/sendAlert?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to get
id	company owner's id(email). It is a sender.
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
messageId	number	message's id	mandatory
messageType	number	message's type. 0:General	mandatory
messageContent	string	message to be sent. messageContent=Base64(message)

Example :

{
    "messageId": 1,
    "messageType": 0,
    "messageContent":"SGVsbG8="
}

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Send a custom message to Channel

1) request

Method	POST
Required	Server 2.0.x ~
URL	{ServerURL}/openapi/1/channels/{cid}/sendCustomMessage?id={userid}&hid={hostid}&skey={sessionkey}
cid	channel's ID to get
id	company owner's id(email). It is a sender.
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
messageId	number	message's id	mandatory
messageContent	string	message to be sent. messageContent=Base64(message)

Example :

{
    "messageId": 1,
    "messageContent":"SGVsbG8="
}

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Get User List

1) request

Method	GET
URL	{ServerURL}/openapi/1/users?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name		type	description	option
users			user list	mandatory
	id	number	user's ID	mandatory
	strId	string	user's ProPTT2 ID(email)	mandatory
	name	string	user's name	mandatory
	type	string	user's type. 20: ProGate, 21: SIP device, 50: Normal, 70: Channel Leader, 80: Dispatcher, 90:Manager (Required Server 3.0.1 ~)	mandatory
	latitude	string	user's last latitude. (Required Server 1.2.x ~)
	longitude	string	user's last longitude. (Required Server 1.2.x ~)
	locationDate	string	last update date of user's location. (Required Server 1.2.x ~)
	level	number	user's level id(Required Server 5.1.0 ~)
	phoneNumber	string	user's phoneNumber(Required Server 5.1.0 ~)
	email	string	user's email(Required Server 5.1.0 ~)

Available error code :

code	description
500	Internal error

Example :

{
    "users":[
        {
            "id" : 1,
            "strId" : "abc@company.ptt",
            "name" : "abc",
            "type" : 50,
            "latitude":"37.4898",
            "longitude":"127.033",
            "locationDate":"2016-07-21 05:42:35"
        },{
            "id" : 2,
            "strId" : "efg@company.ptt",
            "name" : "efg",
            "type" : 50,
            "latitude":"37.4346",
            "longitude":"127.023",
            "locationDate":"2016-07-22 03:22:33"
        }
    ]
}

Create User

1) request

Method	POST
URL	{ServerURL}/openapi/1/users?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
strId	string	user's ProPTT2 id. In package mode it is full email address. In cloud service it is only Id)	mandatory
hashedPassword	string	Lowercase(Base16(Sha512(user's password)))	mandatory
name	number	user's name	mandatory
type	string	user's type. 50: Normal, 70: Channel Leader, 80: Dispatcher, 90:Manager (Required Server 3.0.1 ~)	mandatory
email	string	user's email
description	string	user's description
level	number	user's level id(Required Server 5.1.0 ~)
phoneNumber	string	user's phoneNumber(Required Server 5.1.0 ~)

Example :

{
    "strId": "abc@company.ptt",
    "hashedPassword": "c321ba878",
    "name": "abc",
    "type": 50,
    "email": "abc@company.com",
    "description":"team leader"
}

2) response

field name	type	description	option
id	number	created user's ID	mandatory

Available error code :

code	description
400	Bad Request. Would be paramater invalid
406	Not Acceptable. Would be license limitation
412	Precondition failed. Would be already same ID
500	Internal error

Example :

{
    "id":12
}

Get User

1) request

Method	GET
URL	{ServerURL}/openapi/1/users/{uid}?id={userid}&hid={hostid}&skey={sessionkey}
uid	user's ID to get
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
id	number	user's ID	mandatory
strId	string	user's ProPTT2 id(email)	mandatory
name	string	user's name	mandatory
type	string	user's type. 20: ProGate, 21: SIP device, 50: Normal, 70: Channel Leader, 80: Dispatcher, 90:Manager (Required Server 3.0.1 ~)	mandatory
email	string	user's email
description	string	user's description
latitude	string	user's last latitude. (Required Server 1.2.x ~)
longitude	string	user's last longitude. (Required Server 1.2.x ~)
locationDate	string	last update date of user's location. (Required Server 1.2.x ~)
level	number	user's level id(Required Server 5.1.0 ~)
phoneNumber	string	user's phoneNumber(Required Server 5.1.0 ~)

Available error code :

code	description
500	Internal error

Example :

{
    "id":123
    "strId": "abc@company.ptt",
    "name": "abc",
    "type": 50,
    "email": "abc@company.com",
    "description":"team leader",
    "latitude":"37.4898",
    "longitude":"127.033",
    "locationDate":"2016-07-21 05:42:35"
}

Update User

1) request

Method	PUT
URL	{ServerURL}/openapi/1/users/{uid}?id={userid}&hid={hostid}&skey={sessionkey}
uid	user's ID to be updated
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
name	string	user's name	mandatory
type	string	user's type. 50: Normal, 70: Channel Leader, 80: Dispatcher, 90:Manager (Required Server 3.0.1 ~)
hashedPassword	string	Lowercase(Base16(Sha512(user's password)))
email	string	user's email
description	string	user's description
authToken	string	user's authToken for second authentication (Required Server 2.2.8 ~)
level	number	user's level id(Required Server 5.1.0 ~)
phoneNumber	string	user's phoneNumber(Required Server 5.1.0 ~)
latitude	double	user's last latitude. (Required Server 5.1.0 ~)
longitude	double	user's last longitude. (Required Server 5.1.0 ~)

Example :

{
    "email": "abc@proptt2.com",
    "name": "abc",
    "description":"team leader"
}

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Delete User

1) request

Method	DELETE
URL	{ServerURL}/openapi/1/users/{uid}?id={userid}&hid={hostid}&skey={sessionkey}
uid	user's ID to be deleted
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Send a message to User

1) request

Method	POST
Required	Server 1.2.x ~, SDK 1.2.x ~, Client 1.3.x ~
URL	{ServerURL}/openapi/1/users/{uid}/sendMessage?id={userid}&hid={hostid}&skey={sessionkey}
uid	user's ID to be received
id	company owner's id(email). It is a sender.
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body :

field name	type	description	option
messageId	number	message's id	mandatory
messageContent	string	message to be sent. messageContent=Base64(message)

Example :

{
    "messageId": 1,
    "messageContent":"SGVsbG8="
}

2) response

field name	type	description	option
code	string	result. "200" is success	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "code":"200"
}

Get Organization List

1) request

Method	GET
URL	{ServerURL}/openapi/1/organizations?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name		type	description	option
organizations			radio list	mandatory
	id	number	organization's ID	mandatory
	parentId	number	organization's parent ID. if parent ID is zero, it is root.	mandatory
	name	string	organization's name	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "organizations":[
        {
            "id" : 1,
            "parentId" : 0,
            "name" : "abc"
        },{
            "id" : 2,
            "parentId" : 1,
            "name" : "efg"
        }
    ]
}

Get Organization

1) request

Method	GET
URL	{ServerURL}/openapi/1/organizations/{oid}?id={userid}&hid={hostid}&skey={sessionkey}
oid	organization's ID to get
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
id	string	organization's id	mandatory
parentId	string	organization's parentId	mandatory
name	string	organization's name	mandatory
description	string	organization's description

Available error code :

code	description
500	Internal error

Example :

{
    "id":123,
    "parentId" : 0,
    "name": "abc",
    "description":"office"
}

Get Users Of Organization

1) request

Method	GET
URL	{ServerURL}/openapi/1/organizations/{oid}/users?id={userid}&hid={hostid}&skey={sessionkey}
oid	organization's ID to get
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name		type	description	option
users			user list	mandatory
	id	number	user's ID	mandatory
	strId	string	user's ProPTT2 ID(email)	mandatory
	name	string	user's name	mandatory
	level	number	user's level id(Required Server 5.1.0 ~)
	phoneNumber	string	user's phoneNumber(Required Server 5.1.0 ~)
	email	string	user's email(Required Server 5.1.0 ~)

Available error code :

code	description
500	Internal error

Example :

{
    "users":[
        {
            "id" : 1,
            "strId" : "abc@company.ptt",
            "name" : "abc"
        },{
            "id" : 2,
            "strId" : "efg@company.ptt",
            "name" : "efg"
        }
    ]
}

Get Record List

1) request

Method	GET
URL	{ServerURL}/openapi/1/records?id={userid}&hid={hostid}&skey={sessionkey}
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey
start	start record index. 0 based
pageSize	size to get

Body : Nothing

2) response

field name		type	description	option
records			record list	mandatory
	id	number	record's ID	mandatory
	type	number	10: AudioPTT, 20:VideoPTT, 31:VideoShared	mandatory
	status	number	10: Normal	mandatory
	fileSize	number	file size(KB)	mandatory
	channelId	number	channel id	mandatory
	channelNo	number	channel no	mandatory
	channelName	string	channel's name	mandatory
	ownerId	number	owner id	mandatory
	ownerName	string	owner's name	mandatory
	createDate	string	created date	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "records":[
        {
            "id" : 1,
            "type" : 10,
            "status" : 10,
            "fileSize" : 32,
            "ownerId" : 1,
            "channelId" : 1,
            "channelNo" : 1,
            "channelName" : "channel name",
            "ownerName" : "owner name",
            "createDate" : "2017-11-02 04:29:02"
        },{
            "id" : 2,
            "type" : 10,
            "status" : 20,
            "fileSize" : 40,
            "channelId" : 1,
            "channelNo" : 1,
            "channelName" : "channel name",
            "ownerId" : 1,
            "ownerName" : "owner name",
            "createDate" : "2017-11-02 04:45:02"
        }
    ]
}

Get Record

1) request

Method	GET
URL	{ServerURL}/openapi/1/records/{rid}?id={userid}&hid={hostid}&skey={sessionkey}
rid	record's ID to get
id	company owner's id(email)
hid	source host id(1~10) in auth command
skey	server's sessionkey

Body : Nothing

2) response

field name	type	description	option
id	number	record's ID	mandatory
type	number	10: AudioPTT, 20:VideoPTT, 31:VideoShared	mandatory
status	number	10: Normal	mandatory
fileSize	number	file size(KB)	mandatory
channelId	number	channel id	mandatory
channelNo	number	channel no	mandatory
channelName	string	channel's name	mandatory
ownerId	number	owner id	mandatory
ownerName	string	owner's name	mandatory
createDate	string	created date	mandatory
filepath	string	recorded file path	mandatory

Available error code :

code	description
500	Internal error

Example :

{
    "id" : 2,
    "type" : 10,
    "status" : 20,
    "fileSize" : 40,
    "channelId" : 1,
    "channelNo" : 1,
    "channelName" : "channel name",
    "ownerId" : 1,
    "ownerName" : "owner name",
    "createDate" : "2017-11-02 04:45:02",
    "filepath" : "/proptt2/record/ptt/20171104/ptt-userid.ptt"
}

Reference of ProPTT2 OpenAPI

Auth

Get Server URL

Get Session Key

Keep Alive

Channel

Get Channel List

Create Channel

Get Channel

Update Channel

Delete Channel

Purge All Channels

Link User To Channel

Get Users Of Channel

Update User Of Channel

Unlink User To Channel

Get Records Of Channel(Server 2.2.8~)

Send a sync event to Channel

Send a message to Channel

Send a SOS to Channel

Send an alert to Channel

Send a custom message to Channel

User

Get User List

Create User

Get User

Update User

Delete User

Send a message to User

Organization

Get Organization List

Get Organization

Get Users Of Organization

Record (Server 2.2.8~)

Get Record List

Get Record

Reference