How did the idea come about?

The idea came about through the meeting of friends who only knew each other through the internet, each one with its linguistic-cultural traits, we thought of creating an informal dictionary for the idiomatic expressions that each Brazilian region possessed, so the project was totally collaborative, bringing cultural diversity from each one of us, being able, to deepen in the our Brazilian's daily culture.

Projects using the dialects-service

📃 API

All endpoints live under the URL https://dialetus-service.now.sh and then generally follow the REST architecture.

All requests must be encoded as JSON with the Content-Type: application/json header. Most responses, including errors, are encoded exclusively as JSON as well.

GET /regions

List all regions available with the total mapped dialects.

Request

$ curl https://dialetus-service.now.sh/regions

Response

[{
  "name": "alagoanes",
  "total": 64
}, {
  "name": "baianes",
  "total": 41
}, {
  "name": "carioques",
  "total": 14
}, {
  "name": "catarines",
  "total": 22
}, {
  "name": "cearences",
  "total": 10
}, {
  "name": "gauches",
  "total": 18
}, {
  "name": "mineires",
  "total": 26
}, {
  "name": "paranes",
  "total": 53
}, {
  "name": "paulistes",
  "total": 16
}, {
  "name": "pernambuques",
  "total": 17
}, {
  "name": "potiguares",
  "total": 34
}, {
  "name": "paraense",
  "total": 30
}, {
  "name": "rondones",
  "total": 9
}]

GET /regions/:region/dialects

List all dialects mapped.

Request

$ curl https://dialetus-service.now.sh/regions/baianes/dialects

Response

[
  {
    "slug": "relaxe-mo-fiu",
    "dialect": "Relaxe mô fiu.",
    "meanings": [
      "Sem problemas",
      "Fique tranquilo"
    ],
    "examples": [
      "Ô vei, relaxe mô fiu todo nervoso ele."
    ]
  },
  {
    "slug": "e-bala",
    "dialect": "É bala!",
    "meanings": [
      "algo interessante",
      "massa"
    ],
    "examples": [
      "Que computador bala!"
    ]
  },
  {
    "slug": "comer-agua",
    "dialect": "Comer água!",
    "meanings": [
      "Vodka",
      "Cerveja",
      "Qualquer bebida que contenha álcool"
    ],
    "examples": [
      "Vamo pro reg comer água galera!"
    ]
  },
]

GET /regions/:region/dialects/:slug

Get a dialect by slug.

Request

$ curl https://dialetus-service.now.sh/regions/baianes/dialects/relaxe-mo-fiu

Response

{
  "slug": "relaxe-mo-fiu",
  "dialect": "Relaxe mô fiu.",
  "meanings": [
    "Sem problemas",
    "Fique tranquilo"
  ],
  "examples": [
    "Ô vei, relaxe mô fiu todo nervoso ele."
  ]
}

List of dialects

GET /dialect

GET /dialect

# /dialect/:region
GET /dialect/baianes
GET /dialect/mineires
GET /dialect/paranes
GET /dialect/carioques
GET /dialect/potiguares
GET /dialect/rondones
GET /dialect/cearences
GET /dialect/pernambuques
GET /dialect/catarines
GET /dialect/paraense
GET /dialect/gauches

Respect earns Respect 👏

Please respect our Code of Conduct, in short:

Using welcoming and inclusive language
Being respectful of differing viewpoints and experiences
Gracefully accepting constructive criticism
Focusing on what is best for the community
Showing empathy towards other community members

Contribute 🍕

Please take a look at the contributing guide.

Authors 😎

Marcus Silva (@mvfsillva)
Angelmario Santana (@anfsantana)
Jader Gomes (@jdrgomes)
Rodolfo Silva (@RodolfoSilva)

Contributors 🎉

Thanks goes out to all these wonderful people (emoji key):

_{Marcus Silva} 💻 📖 👀	_{Angelmário Santana} 💻 📖 👀	_{Rodolfo Silva} 💻 📖 👀	_{Bruno Pulis} 💻	_{Wellington Mitrut} 💻	_{Diego Ramos} 💻	_{Caio Alcântara} 💻
_{Lucas Farias} 💻	_{Higor Morais} 💻	_{Medson Mendes} 💻	_{Randѕon Oliveira} 💻	_{Murillo de Miranda Pereira} 💻	_{Rafael Nunes} 💻	_{Will Mendes} 💻
_kathleenrego 💻	_Jader 💻	_{Rodolfo Candido} 💻	_{Jefferson Moura} 💻	_{Raphael Amorim} 💻	_{Adriano Canofre} 💻	_{Maurício Coelho} 💻
_{Marcela Barella} 💻	_{Matheus Monte} 💻	_{Gabriel Kalani} 💻