T1C-JS Guide (v2)
v2.4.1
Search…
⌃K

Status codes

HTTP Status Codes

T1C-GCL uses the following HTTP response codes when handling a request.
Code
Description
Info
200
Success
The request was successful
400
Bad Request
The request input contains errors (e.g. wrong json)
408
Request Timeout
The maximum wait time was exceeded without receiving a result
412
Precondition Failed
An application error occurred while handling the request (e.g. pin blocked)
In case of an error (400 or 412) the response will contain a body with more detailed information about the error:
{
success: false,
description: "some error description",
code: "some error code"
}
All possible values of the codes are described below in "Application Status Codes" The description field contains more information and a stack trace from the exception.

Application Status Codes

Code
Description
0
Card reader error
1
No reader found
2
Card reader is not compatible with this request
Code
Description
100
Card error
101
Card not present
102
Wrong card (not an eID)
103
Wrong pin, 2 tries remaining
104
Wrong pin, 1 try remaining
105
Pin blocked
106
Invalid Pin
107
Verify Pin not supported on reader
108
Application locked
109
Verify Pin cancelled
110
Verify Pin timed out
111
Wrong pin, 4 tries remaining
112
Wrong pin, 3 tries remaining
113
PUK blocked
114
Dialog error
115
Failed to retrieve the code from the os dialog

Security errors

Code
Description
200
JWT token is malformed
201
No valid certificate available
202
JWT token algorithm is not supported
203
JWT token has an incorrect signature
204
JWT token UID is incorrect
205
JWT token is expired
206
No private key
207
JWT token does not contain an application
208
Not allowed to view the log files
299
Security error

Library errors

Code
Description
300
Failed to load the library
301
Installed GCL incompatible with library version
302
No GCL installation found

Session errors

Code
Description
400
Session error
401
No active session
402
Invalid session id

Agent errors

Code
Description
500
Agent error
501
Unknown agent

Pin Enforcement errors

Code
Description
600
PIN provided when no PIN was expected
601
PIN not provided when it was expected to be present

Input errors

Code
Description
800
Invalid json
801
Invalid arguments
802
Invalid HTTP request
803
X-Authentication-Token header missing
804
Invalid X-Authentication-Token header
805
Origin and referer header are missing
806
X-Relay-State header is missing
807
Invalid X-Relay-State header

General errors

Code
Description
900
Internal error
901
Invalid configuration
902
Invalid container configuration
903
Container download failed
904
Container download timeout
999
Network error. See troubleshooting hints here.