AS
ALOC Stationdeveloper docs
DOCS/DEVELOPER PORTAL
v1.0.0
folio 1.3 — upgrade path

Migrating from Legacy ALOC Endpoints to ALOC Station

A comprehensive migration blueprint for developers transitioning from legacy questions.aloc.com.ng endpoints to modern ALOC Station assessment infrastructure.

Official Migration Window: July 2026 – July 31, 2027
1-Year Grace Period

The legacy endpoint service (questions.aloc.com.ng) continues to support over 3,000 active developers until July 31, 2027. While legacy endpoints remain operational for existing applications, all new features, curriculum taxonomy (L2), AI step-by-step worked solutions (L3), official SDKs, and Model Context Protocol (MCP) tooling are exclusive to ALOC Station.

Architecture Evolution: What Changes?

Legacy ALOC was designed as a flat question retrieval feed. ALOC Station transforms this into a multi-layered assessment engine with psychometric seeding, anti-cheating sessions, and deep curriculum taxonomy.

DimensionLegacy (v1/v2 aloc-endpoints)ALOC Station (Modern)
Base URLhttps://questions.aloc.com.ng/api/v2https://dev.aloc.com.ng/api/v1
AuthenticationAccessToken: <token> headerX-ALOC-KEY: <key> / Bearer header
Developer ToolingRaw HTTP / cURL onlyTypeScript SDK, Python SDK, MCP Server
Data DepthRaw question & static answer (L1)L1 (Raw), L2 (Taxonomy), L3 (Solutions), L4 (Vector)
Exam Session StateManual client state managementBuilt-in candidate session lifecycle & seeding
Monthly QuotaLegacy plan rates1,000 Free Credits/mo + Instant top-ups

Endpoint Mapping Matrix

Use this cheat-sheet to replace legacy API requests with their Station equivalents:

Legacy: GET /api/v2/q?subject=chemistrySingle Question
Station: GET /api/v1/questions?subject=chemistry&limit=1Layer: L1
Legacy: GET /api/v2/m?subject=chemistryBatch Questions (40 fixed)
Station: POST /api/v1/assessments/generate or GET /api/v1/questions?limit=40Layer: L1/Assessment
Legacy: GET /api/v2/q-by-id/:id?subject=chemistryLookup by ID
Station: GET /api/v1/questions/:idLayer: L1
Legacy: Not AvailableStep-by-Step Worked Solutions
Station: GET /api/v1/explanations/:question_idLayer: L3

Code Migration Examples

JavaScript / TypeScript Migration
Before (Legacy HTTP)
const res = await fetch(
  "https://questions.aloc.com.ng/api/v2/q?subject=chemistry&year=2020",
  { headers: { "AccessToken": process.env.ALOC_TOKEN } }
);
const data = await res.json();
After (ALOC SDK)
import { AlocClient } from "@massteck/aloc-sdk";
const aloc = new AlocClient({ apiKey: process.env.ALOC_API_KEY });
const q = await aloc.questions.get({ subject: "chemistry", year: 2020 });
console.log(q.text, q.bloomTaxonomy);
Python Migration
Before (Legacy Requests)
import requests
res = requests.get(
    "https://questions.aloc.com.ng/api/v2/q",
    headers={"AccessToken": "YOUR_TOKEN"},
    params={"subject": "physics", "type": "utme"}
)
After (ALOC Station REST / SDK)
import requests
res = requests.get(
    "https://dev.aloc.com.ng/api/v1/questions",
    headers={"X-ALOC-KEY": "YOUR_API_KEY"},
    params={"subject": "physics", "exam": "jamb"}
)

3 Simple Steps to Complete Your Migration

  1. Generate an ALOC Station API Key: Create your free developer account at aloc.com.ng/register to receive 1,000 free monthly credits.
  2. Install the Official SDK: Run npm install @massteck/aloc-sdk or configure the REST endpoint.
  3. Explore the Interactive Playground: Test questions, taxonomy, and step-by-step solutions instantly on the API Playground.
Need dedicated migration assistance for high-volume enterprise pipelines?Contact Engineering Support →