JWT Parsing and Verification API

1. Basic Usage

TIP

This API parses and verifies JWT (JSON Web Token, based on HS256 algorithm), returning the decoded payload or error information.

Base API URL:

https://zeapi.ink/v1/api/jwt

Parse a JWT via GET request:

https://zeapi.ink/v1/api/jwt?token=your_jwt_token

Or via POST request with JSON data:

{
    "token": "your_jwt_token"
}

Shell request examples:

curl -X GET "https://zeapi.ink/v1/api/jwt?token=your_jwt_token"

Or using POST:

curl -X POST https://zeapi.ink/v1/api/jwt \
-H "Content-Type: application/json" \
-d '{"token": "your_jwt_token"}'

2. Request Parameters

Parameter	Type	Required	Default	Description
token	string	Yes	None	JWT token to parse and verify

TIP

• For GET requests, provide the JWT via the token query parameter.
• For POST requests, provide the JWT in the token field of the JSON data.
• The JWT must be signed with the HS256 algorithm, and the signature key must match the server’s key.

3. JSON Response Format

Success response example:

{
    "status": "success",
    "data": {
        "sub": "user123",
        "name": "John Doe",
        "iat": 1697059200,
        "exp": 1697062800
    }
}

Error response example (missing token parameter):

{
    "error": "Bad Request",
    "message": "Missing token parameter"
}

Error response example (expired token):

{
    "error": "Unauthorized",
    "message": "Token has expired"
}

Error response example (invalid signature):

{
    "error": "Unauthorized",
    "message": "Invalid token signature"
}

Error response example (invalid token):

{
    "error": "Bad Request",
    "message": "Invalid token"
}

4. Response Fields

Field	Type	Description
status	string	Request status, success on success
data	object	Decoded JWT payload, containing claims (e.g., sub, name, iat, exp)
error	string	Error message (returned only on failure)
message	string	Detailed error description (returned only on failure)