{
  "name": "Vietnamese Text Toolkit API",
  "version": "1.0.0",
  "usage": {
    "method": "POST",
    "content_type": "application/json; charset=utf-8",
    "note": "Gửi payload từ file để giữ đúng UTF-8. KHÔNG truyền tiếng Việt inline trong shell."
  },
  "endpoints": {
    "/v1/remove-tones": {
      "body": {
        "text": "Nguyễn Văn Á"
      },
      "returns": {
        "result": "Nguyen Van A",
        "input_length": 12
      }
    },
    "/v1/normalize": {
      "body": {
        "text": "Nguyễn   Văn Á",
        "form": "NFC",
        "collapse_whitespace": true
      },
      "returns": {
        "result": "Nguyễn Văn Á"
      }
    },
    "/v1/word-count": {
      "body": {
        "text": "Nguyễn Văn Á"
      },
      "returns": {
        "result": {
          "characters": 12,
          "words": 3
        }
      }
    },
    "/v1/slugify": {
      "body": {
        "text": "Lập trình viên",
        "separator": "-"
      },
      "returns": {
        "result": "lap-trinh-vien"
      }
    },
    "/v1/num-to-words": {
      "body": {
        "number": 1500000
      },
      "returns": {
        "result": "một triệu năm trăm nghìn",
        "number": 1500000
      },
      "note": "Trường là 'number' (số), KHÔNG phải 'text'. Chỉ nhận số nguyên |n| <= 2^53-1."
    },
    "/v1/normalize-name": {
      "body": {
        "text": "  nguyễn   văn   á  "
      },
      "returns": {
        "result": "Nguyễn Văn Á"
      }
    },
    "/v1/match-name": {
      "body": {
        "a": "Nguyễn Văn Á",
        "b": "nguyen van a"
      },
      "returns": {
        "result": {
          "match": true,
          "score": 1
        }
      },
      "note": "Hai trường 'a' và 'b' (string), KHÔNG phải 'text'."
    },
    "/v1/words-to-number": {
      "body": {
        "text": "một triệu năm trăm nghìn"
      },
      "returns": {
        "result": 1500000
      }
    }
  }
}