API Developer Docs

Integration references for authentication, search, repository, and billing workflows.

POST

Authenticate User

/api/v1/auth/login

Returns session cookie and role profile after validating credentials.

curl -X POST /api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@unilag.edu.ng","password":"********"}'

GET

Hybrid Search

/api/v1/search?q=machine+learning

Performs tenant-scoped hybrid retrieval with ranking fusion.

fetch('/api/v1/search?q=machine+learning&page=1')
  .then((r) => r.json())
  .then(console.log);

GET

Entitlement Check

/api/v1/entitlements/check?resource_id=<id>

Checks whether current authenticated user can access a resource.

const res = await fetch('/api/v1/entitlements/check?resource_id=<uuid>');
const body = await res.json();
// { entitled: boolean }

Response Format

{
  "items": [{ "id": "uuid", "title": "Resource title" }],
  "total": 120,
  "page": 1,
  "per_page": 20
}