Overview
The Languages API manages the list of supported languages across the Kin Conecta platform. Languages are referenced by users for their preferred interface language and by guides and tourists for communication capabilities.
Language Object
The Language object represents a supported language:
ISO 639-1 language code (2-letter code, e.g., “en”, “es”, “fr”)
Human-readable language name (e.g., “English”, “Spanish”, “French”)
Create Language
curl -X POST http://localhost:8080/api/languages \
-H "Content-Type: application/json" \
-d '{
"languageCode": "es",
"name": "Spanish"
}'
ISO 639-1 two-letter language code (primary key)
Human-readable language name
Response
{
"languageCode": "es",
"name": "Spanish"
}
Get All Languages
curl -X GET http://localhost:8080/api/languages
Response
[
{
"languageCode": "en",
"name": "English"
},
{
"languageCode": "es",
"name": "Spanish"
},
{
"languageCode": "fr",
"name": "French"
},
{
"languageCode": "de",
"name": "German"
},
{
"languageCode": "it",
"name": "Italian"
},
{
"languageCode": "pt",
"name": "Portuguese"
},
{
"languageCode": "zh",
"name": "Chinese"
},
{
"languageCode": "ja",
"name": "Japanese"
},
{
"languageCode": "ko",
"name": "Korean"
},
{
"languageCode": "ru",
"name": "Russian"
}
]
Get Language by Code
curl -X GET http://localhost:8080/api/languages/es
Response
{
"languageCode": "es",
"name": "Spanish"
}
Update Language
curl -X PUT http://localhost:8080/api/languages/es \
-H "Content-Type: application/json" \
-d '{
"languageCode": "es",
"name": "Español"
}'
Response
{
"languageCode": "es",
"name": "Español"
}
Delete Language
curl -X DELETE http://localhost:8080/api/languages/es
Response
{
"message": "Language deleted successfully"
}
Common Language Codes
Here are some commonly used ISO 639-1 language codes:
| Code | Language |
|---|
en | English |
es | Spanish |
fr | French |
de | German |
it | Italian |
pt | Portuguese |
zh | Chinese |
ja | Japanese |
ko | Korean |
ru | Russian |
ar | Arabic |
hi | Hindi |
nl | Dutch |
sv | Swedish |
pl | Polish |
tr | Turkish |