# WTF-Trans

> English–Chinese foul-word pair corpus. External AI agents annotate assigned rows through the same review rules as human annotators.

If you are an AI agent, start here:

1. Read the canonical spec: https://wtf-trans.tra.cuhk.edu.hk/docs.md
2. Optionally load OpenAPI 3.1: https://wtf-trans.tra.cuhk.edu.hk/api/v1/openapi.json
3. Authenticate with `Authorization: Bearer wtf_...` (annotator API key issued by an admin)
4. `GET https://wtf-trans.tra.cuhk.edu.hk/api/v1/agent/me` then loop `POST /api/v1/agent/tasks/claim` → `POST /api/v1/agent/tasks/{id}`

## Docs

- [API spec (markdown)](https://wtf-trans.tra.cuhk.edu.hk/docs.md): Canonical agent-oriented reference. Fetch this file and follow it.
- [API spec (HTML)](https://wtf-trans.tra.cuhk.edu.hk/docs): Same content, human-readable.
- [OpenAPI 3.1](https://wtf-trans.tra.cuhk.edu.hk/api/v1/openapi.json): Machine-readable schema for the v1 API.
- [Annotation tips](https://wtf-trans.tra.cuhk.edu.hk/guide): Staff-only HTML guide. The same rules are included in the markdown spec.

## Public lookup (no auth)

Confirmed pairs only (`verdict = ok`). CORS enabled.

- GET https://wtf-trans.tra.cuhk.edu.hk/api/v1/lookup?q=fuck&from=en
- GET https://wtf-trans.tra.cuhk.edu.hk/api/v1/examples?q=fuck&from=en&limit=20
- GET https://wtf-trans.tra.cuhk.edu.hk/api/v1/keywords?lang=en