[API-users] language parameter of Species API

[Markus Döring]

Hi James,

I can confirm we have a bug requesting the language via http header.
I've created a jira for this:
http://dev.gbif.org/issues/browse/POR-2411

Thanks!

Markus



On 21 Aug 2014, at 09:38, Markus Döring <mdoering at gbif.org> wrote:

> Hi James,
> it is correct that we default to english for non existing languages. I agree it might be confusing when you requested sth different and it might be hard to tell what language that name actually represents.
> We will consider returning null in those cases.
> 
> As for the http headers Ill take a look and file a bug report.
> Thanks!
> 
> Markus
> 
> 
> 
> On 21 Aug 2014, at 03:26, Nozomi James Ytow <nozomi at biol.tsukuba.ac.jp> wrote:
> 
>> Hi,
>> 
>> SpeciesAPI document
>> http://www.gbif.org/developer/species
>> specifies language parameter of simple get species, i.e. species/{int}.
>> Language parameter is explained at
>> http://www.gbif.org/developer/species#p_language
>> as "default=en or use HTTP header for this", 
>> 
>> I tried to specify 'de' in HTTP header as Language request property,
>> but it doesn't work.   Instead, http://api.gbif.org/v1/species/5231190?language=de works fine.
>> Do I misunderstand the documentation?
>> 
>> I also tried languages are not included in vernacular names list
>> http://api.gbif.org/v1/species/5231190/vernacularNames
>> such as http://api.gbif.org/v1/species/5231190?language=ja or zh or kr...
>> I expected empty field for vernacularName or no record returned, but I got English one.
>> It is misleading implementation that one ignorant of the language specified can misundarstand
>> that the language uses the same word with English.
>> I suggest to return null vernacularName if vernacular name of specified language is unavailable.
>> 
>> Cheers,
>> James
>> 
>> 
>> 
>> 
>> 
>> _______________________________________________
>> API-users mailing list
>> API-users at lists.gbif.org
>> http://lists.gbif.org/mailman/listinfo/api-users
>> 
> 
> _______________________________________________
> API-users mailing list
> API-users at lists.gbif.org
> http://lists.gbif.org/mailman/listinfo/api-users
>