I think I figured out why the java-api tag exists, or at least one reason. I perused the questions with that tag and I saw several that were primarily about technologies other than Java, for example, Elasticsearch. That's a language-independent technology that has APIs for different languages -- language bindings -- including Java, JavaScript, Go, .NET, etc.
In other words, the java-api tag is not about the APIs of Java and the JDK, but it is about the Java API bindings for other technologies such as Elasticsearch.
To pick another example, suppose you're using MongoDB and are writing in Java. You might run into a problem with the MongoDB driver for Java and want to ask a Stack Overflow question about it. You'd tag your question with mongodb since that's what you're using, and you might also add the java-api tag since you're using MongoDB's Java binding.
This is pretty subtle. I don't know if it's the best use of Stack Overflow tagging, or if there's some better combination tags that would express this more precisely. I do think it's confusing, as there are a bunch of questions about Java's APIs themselves (that is, the JDK) mixed in there.
We might try to tune up the tag's definition. Or we could just get rid of it and make it a synonym.
UPDATE 2020-05-03
I've done a bit more research and discovered that the "meta-tag" approach of using java-api to tag questions about the Java language API binding for some cross-platform technology isn't used anywhere else as far as I can tell. Instead, there are technology-specific tags that also have "java" (or whatever language) in the name, to indicate a language/environment binding for that technology.
I took a quick look at other technologies' tags and I found these related tags for them:
Elasticsearch: elasticsearch-dsl, elasticsearch-painless, elasticsearch-net, elasticsearch-py, elasticsearch-jdbc-river, elasticsearch-java-api
MongoDB: pymongo, mongoid, mongodb-.net-driver, mongodb-java, mongodb-php
MySQL: mysqli, mysql-python, pymysql, node-mysql, rmysql, mysql-connector-python, mysqlnd
I suspect that most cross-platform technologies follow a similar pattern and have "sub-tags" for drivers or bindings for working with different platforms, languages, or environments.
There aren't very many java-api questions to begin with, and only some of them are tagged this way. Its remaining use seems to be an attractor for random questions about the Java Platform APIs. This isn't useful, as there are already a bunch of java-related tags.
As such, java-api no longer serves any useful purpose, and I now agree with Makoto that the java-api tag can be synonymized with java.