CountryCode (beta)

http://api.tumbapi.com/countrycode/

CountryCode è un servizio basato sullo standard ISO 3166-1 che fornisce i codici per i nomi delle nazioni. I benefici dell'utilizzo di questi codici sono più importanti di quello che possono sembrare, dal sito ufficiale ISO.org vorrei citarne soltanto due:

1.- All national postal organizations in the world exchange international mail between them in containers carrying ISO 3166-1 codes for identification of the country of destination.

2.- The Internet domain name sytems uses ISO 3166-1 alpha-2 codes to define country-coded Top-Level Domains (ccTLDs), e.g., for the countries listed above; ".fr", ."za", ".au", ".br", or ".jp".

Se volete approfondire l'argomento potete visitare i seguenti indirizzi:

Come funziona

È molto semplice, http://api.tumbapi.com/countrycode/ è un indirizzo pubblico che accetta solo richieste con il metodo POST, infatti se fai click sull'indirizzo http://api.tumbapi.com/countrycode/ troverai la scritta: "method GET is not supported".

La richiesta usando il metodo POST restituisce l'elenco delle nazioni e il codice Alpha-2 (es. Italy, IT), in assenza delle variabili restituisce una List/menu (<select>) in lingua inglese.

Se fai click sul pulsante "Generate CountryCode" vedrai nella pratica di cosa stiamo parlando:

key:

 

Variabili

Al momento (03/07/2009 17.53.20) ci sono 3 variabili da impostare:

tumbapi_key = value (obbligatorio)

Per il periodo di prova (beta) la variabile deve essere impostata con il valore a 12 caratteri alphanumerici: 01234567beta. Successivamente verrà notificata la data in cui sarà richiesta ufficialmente la tumbapi_key per l'utilizzo (sempre gratuito) personalizato del servizio.

lang = value (opzionale 'en by default')

L'elenco dei nomi e codice Alpha-2 delle nazioni sono reperibili in rete, dal sito iso.org si possono scaricare i file contenenti l'informazione. Questi dati, però, sono disponibili soltanto in Inglese e Francese. Api.tumbapi.com/countrycode/ rende disponibile per ora (03/07/2009 17.53.20) l'informazione in 6 lingue. I valori devono essere impostati in LowerCase (miniscole).

Lingue disponibili: it | en | es | fr | ja | ru

Per richiedere i nomi delle nazioni in italiano basta impostare lang="it"

f = value (opzionale 'select by default')

L'informazione è disponbile in 4 formati, impostando la variabile f potrai visualizzare l'informazione in questi modi:

Se fai click sul pulsante "Generate CountryCode" impostando le variabili, vedrai nella pratica di cosa stiamo parlando:

key:

 

XmlHttpRequest

Per chi volesse utilizzare il servizio all'interno delle proprie applicazioni, ecco alcuni esempi:

ASP

<%
option explicit
 Dim link_url
 Dim tumbapi_key
 Dim lang
 Dim f
 Dim strPost
 Dim xmlhttp
 Dim status

Response.Charset = "UTF-8"
link_url = "http://api.tumbapi.com/countrycode/"
tumbapi_key="01234567beta"

lang = "ru" ' it | en | es | fr | ru | ja
f="html" 'txt | html | select | xml

strPost = "lang="&lang&"&f="&f&"&tumbapi_key="&tumbapi_key&""

set xmlhttp = server.createobject("MSXML2.XMLHTTP")
xmlhttp.open "POST", link_url, false
xmlhttp.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"
xmlhttp.send (strPOST)

status = CInt(XMLHTTP.status)

session.CodePage = 65001
if status = 200 then
 Response.write (XMLHTTP.responseText)
else
  Response.write "<P>Errore: " & status
end if

%>

 

Donate

Come ho scrito sopra, il servizio è gratuito e rimarrà gratuito. Ciononostante, se vuoi, puoi contribuire con una donazione, all'ulteriore sviluppo del servizio. Ogni aiuto sarà di certo gradito. :)

 

Contatti

Per informazioni generali, richieste specifiche o segnalazioni, puoi scriverci all'indirizzo: tumbapi@980km.com