Υλνούνα Intern API

API Reference for Intern Resource Management System

View Endpoints

API Endpoints

GET

/v1/resources

Public

Returns all available resources

GET /v1/resources
Host: api.intern.ylvnyna.com
Accept: application/json
{
  "status": "success",
  "data": [
    {
      "id": "r-4389",
      "type": "resource",
      "metadata": {...}
    }
  ]
}
POST

/v1/resources

Protected

Creates a new resource

POST /v1/resources
Host: api.intern.ylvnyna.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

{
  "name": "example",
  "type": "resource"
}
{
  "status": "success",
  "data": {
    "id": "r-7654",
    "uri": "https://api.intern.ylvnyna.com/v1/resources/r-7654"
  },
  "message": "Resource created successfully"
}

Authentication

Bearer Token

Use Bearer token in Authorization header for authenticated endpoints

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxx

JWT Token Info

  • • Valid for 24 hours after creation
  • • Includes aud, exp, and iss claims
  • • RS256 signing algorithm
  • • Rotated hourly for security

Common Response Codes

200

OK

Request processed successfully

401

Unauthorized

Missing/invalid authentication token

404

Not Found

Requested resource does not exist

429

Rate Limited

Too many requests in 1 minute window

500

Internal Error

Service encountered unexpected error

400

Bad Request

Malformed request (invalid JSON, missing fields)