NCSI

Joseph's NCSI Service

Welcome to Joseph's NCSI Service. This is a simple echo-reply service like Google Captive Portal or Microsoft NCSI.

This service is only for personal use, no no warranty or guarantee. Be careful if you have businesses depend on this service.

Table of Contents

Generate 204

GET /generate_204
See Example

Return HTTP status 204 No Content without body.

Connection Test

GET /connecttest.txt
See Example

Return plain text Joseph's Connection Test without line final.

Simple APIs

IP Address

GET /ip
See Example

Return IP address of client. Example: 203.0.113.1.

User Agent

GET /ua
See Example

Return User-Agent if clent. Example: curl/7.55.1.
The response can be empty with status 200 if client does not send a User-Agent header.

Current Server Timestamp

GET /ts
See Example

Return the current timestamp on server.

Clock

GET /clock/[?params]

A danymic clock showing current time and tick every second. Can be used in browser, OBS or embedded devices.
Clock time is based on system time of your device, so make your system time is set correctly.
The clock does not support Microsoft Internet Browser. To use this clock, you must enable JavaScript.

Default | ISO 8601 | RFC 2822 | HTTP RFC 7231 | Timestamp

Query String Parameters

Please don't forget to do URL encode.

Name Default Description
background #ffffff Background color
color #000000 Text color
format #000000 Time format, see below
tz 480 Timezone UTC offset in minutes
Timezone calculation example: UTC+8 = 480 = 8 * 60
lcd false If set to true, show time in LCD-style font.

Time Foramts

The time formatting function is provided by moment.js. Please follow its documentation of time formatting. There are some alias of time format, see below.

Format Example Description
(NOT SET) 2006-01-02 15:04:05 Default format
timestamp 1136185445 UNIX timestamp, 64-bit signed integer
iso 2006-01-02T15:04:05+08:00 ISO 8601 format
rfc Mon, 02 Jan 2006 15:04:05 +0800 RFC 2822 format
http Mon, 02 Jan 2006 07:04:05 GMT RFC 7231 aka. HTTP header format
Timezone will be set to GMT, parameter tz is ignored.