Currently the API only uses the singular and plural form of type names, e.g. gene and genes. The singular always gets a type by identifier and throws an error if it's not found. The plural, however, may be a search for the type or an endpoint that retrieves more than one element of the type. This is ambiguous and is becoming an issue both for end users and when interpreting the code. For this reason, a descriptor should be added to each endpoint that describes what it's doing, e.g. getGene, getGenes, and searchGenes. This will also be useful as we start to add endpoints for analyses, e.g. findOverlaps.
Currently the API only uses the singular and plural form of type names, e.g.
geneandgenes. The singular always gets a type by identifier and throws an error if it's not found. The plural, however, may be a search for the type or an endpoint that retrieves more than one element of the type. This is ambiguous and is becoming an issue both for end users and when interpreting the code. For this reason, a descriptor should be added to each endpoint that describes what it's doing, e.g.getGene,getGenes, andsearchGenes. This will also be useful as we start to add endpoints for analyses, e.g.findOverlaps.