Documentation

API Collection

Ankiren Linguistic API

API for managing NLP datasets in the Linguistic microservice. ## Features - **Dataset Catalog**: Browse and manage NLP dataset metadata - **Token Search**: Search through dataset tokens with mixed token/tag sequence matching - **Tag Statistics**: View POS tag distributions and counts - **Export**: Download filtered search results as TSV files ## Authentication - Public endpoints (GET) require no authentication - Admin endpoints (POST, PUT, DELETE) require JWT with admin role - JWT can be passed via: - `Authorization: Bearer <token>` header - `authjs.session-token` cookie ## Data Storage - Dataset metadata is stored in Cloudflare D1 (SQLite) - Token data is stored in Cloudflare R2 (object storage) in VLSP format

Productionhttps://linguistic.ankiren.comStaginghttps://linguistic-staging.ankiren.comUAThttps://linguistic-uat.ankiren.comLocal developmenthttp://localhost:3005
BASEhttps://linguistic.ankiren.com

Overview

8 endpoint trong 4 nhóm · OpenAPI 3.0.3 · phiên bản 2.0.0 · spec tại docs/api/linguistic-api.yaml.

Datasets5 endpoint

NLP dataset catalog management

Tokens1 endpoint

Token search and browsing within datasets

Tags1 endpoint

POS tag statistics and information

Export1 endpoint

Export search results as downloadable files

Authentication

Mọi endpoint đều yêu cầu xác thực.

  • BearerAuthhttp · bearer

    JWT token from shell app authentication

  • CookieAuthapiKey · cookie

    Session cookie from shell app

cURL
curl 'https://linguistic.ankiren.com/api/datasets' \
  -H 'Authorization: Bearer <token>'

Topics

Datasets

NLP dataset catalog management

Tokens

Token search and browsing within datasets

Tags

POS tag statistics and information

Export

Export search results as downloadable files