SERVICE EndPoint : https://api.minitalk.io/service
미니톡 채팅호스팅 및 서버호스팅을 이용하는 경우, 외부에서 미니톡 서비스와 관련된 데이터를 이용할 수 있도록 서비스 REST API 를 제공하고 있습니다.
해당 REST API 를 이용하기 위해서는 미니톡 서비스의 client_id 및 client_secret 값이 필요하며, 해당 정보는 미니톡 서비스 신청 후 마이페이지 > 나의 서비스 관리 메뉴에서 확인하실 수 있습니다.
- 무료호스팅 서비스를 이용중인 사용자만 사용가능합니다.
- 채팅호스팅 서비스를 이용중인 사용자만 사용가능합니다.
- 서버호스팅 서비스를 이용중인 사용자만 사용가능합니다.
- 서버라이선스 구입 후 서버를 직접 설치한 사용자만 사용가능합니다.
/:client_id/channels
무료호스팅 또는 채팅호스팅에 현재 접속자가 있는 채널명과 해당 채널에 접속한 유저수를 가져옵니다.
접속자가 존재하는 채널이 없는 경우 channels 값은 NULL 일 수 있습니다.
채널 접속자수는 실시간이 아니라, latest_update 시각의 접속자수를 의미하며, 접속자수는 최대 5분마다 갱신되고 있습니다.
요청주소의 [client_id] 부분에 자신의 서비스(채팅호스팅, 서버호스팅)의 클라이언트 아이디를 대입하여 요청해야 합니다.
Headers
- Name Type Description
- MINITALK_CLIENT_SECRET string 미니톡 서비스의 클라이언트 암호화키
Example
curl -X GET "https://api.minitalk.io/service/:client_id/channels" \ -H "MINITALK_CLIENT_SECRET: $MINITALK_CLIENT_SECRET"
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.minitalk.io/service/:client_id/channels");
curl_setopt($ch, CURLOPT_POST, false);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
"MINITALK_CLIENT_SECRET: $MINITALK_CLIENT_SECRET"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code == 200) {
var_dump(json_decode($data));
}
?>
자바스크립트를 사용하여 이 REST API 를 호출할 경우 브라우저의 소스보기를 통하여 인증정보가 담긴 헤더 데이터가 노출될 수 있습니다.
소스가 노출되지 않는 환경에서만 사용하시거나, PHP 등을 이용하여 인증정보가 노출되지 않도록 주의하시기 바랍니다.
소스가 노출되지 않는 환경에서만 사용하시거나, PHP 등을 이용하여 인증정보가 노출되지 않도록 주의하시기 바랍니다.
$.ajax({
type: "GET",
url: "https://api.minitalk.io/service/:client_id/channels",
dataType: "json",
beforeSend: function(xhr) {
xhr.setRequestHeader("MINITALK_CLIENT_SECRET", "$MINITALK_CLIENT_SECRET");
},
error: function(xhr, status, error) {
console.log(error);
},
success: function(result) {
console.log(result);
}
});
Test
미니톡 홈페이지에 로그인한 경우, 회원님의 데이터를 사용하여 테스트해볼 수 있습니다.
/:client_id/status
특정 클라이언트 아이디를 가진 자신의 서비스의 상태정보를 확인할 수 있습니다.
요청주소의 [client_id] 부분에 자신의 서비스(채팅호스팅, 서버호스팅)의 클라이언트 아이디를 대입하여 요청해야 합니다.
Headers
- Name Type Description
- MINITALK_CLIENT_SECRET string 미니톡 서비스의 클라이언트 암호화키
Example
curl -X GET "https://api.minitalk.io/service/:client_id/status" \ -H "MINITALK_CLIENT_SECRET: $MINITALK_CLIENT_SECRET"
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.minitalk.io/service/:client_id/status");
curl_setopt($ch, CURLOPT_POST, false);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
"MINITALK_CLIENT_SECRET: $MINITALK_CLIENT_SECRET"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code == 200) {
var_dump(json_decode($data));
}
?>
자바스크립트를 사용하여 이 REST API 를 호출할 경우 브라우저의 소스보기를 통하여 인증정보가 담긴 헤더 데이터가 노출될 수 있습니다.
소스가 노출되지 않는 환경에서만 사용하시거나, PHP 등을 이용하여 인증정보가 노출되지 않도록 주의하시기 바랍니다.
소스가 노출되지 않는 환경에서만 사용하시거나, PHP 등을 이용하여 인증정보가 노출되지 않도록 주의하시기 바랍니다.
$.ajax({
type: "GET",
url: "https://api.minitalk.io/service/:client_id/status",
dataType: "json",
beforeSend: function(xhr) {
xhr.setRequestHeader("MINITALK_CLIENT_SECRET", "$MINITALK_CLIENT_SECRET");
},
error: function(xhr, status, error) {
console.log(error);
},
success: function(result) {
console.log(result);
}
});
Test
미니톡 홈페이지에 로그인한 경우, 회원님의 데이터를 사용하여 테스트해볼 수 있습니다.