Skip to content

Latest commit

 

History

History
67 lines (43 loc) · 2.45 KB

README.md

File metadata and controls

67 lines (43 loc) · 2.45 KB

check-name

Simplest, cheapest and easiest API to check if there is a correct first name in a string

Gif: Say my name

Introduction

If you are creating chatbots probably you have already asked the name of some user. For instance:

Bot: Hi there, what is your name?  
User: Rafael Pacheco  
Bot: Welcome, Rafael Pacheco. I'm very happy to talk with you.  

Result: 😀👍

Note that in this sample the Bot use the user input believing that it's a real and valid name. However, if the user sends something different than a name the result can be terrible, as shown below:

Bot: Hi there, what is your name?  
User: go F#%K yourself  
Bot: Welcome, go F#%K yourself. I'm very happy to talk with you.  

Result: 😔👎

This API was built in order to verify if there are correct first names in a string.

How to use

Base URL for all endpoints https://check-name.herokuapp.com/

The response time will likely be a few seconds long on the first request, because this app is running on a free Heroku dyno. Subsequent requests will behave as normal.

Easiast way:

curl -i -X GET https://check-name.herokuapp.com/verify/Rafael%20Pacheco

If you need more details take a look the following links 👇

Endpoints

/verify Retrieve the analyze about some name.
/suggest Enable users to suggest any valid name not recognized by this API.


By the way, this project is based on:

  • PT-BR - the last Brazillian Censo (2010), there are more than 130,000 different first names of people in Brazil. The IBGE is the government institute responsible for this research. Click here if you want to get all the research database.

  • EN-US - National Data on the relative frequency of given names in the population of U.S. births where the individual has a Social Security Number. Tabulated based on Social Security records as of March 4, 2018.

Note: This API should work for a huge number of names. However, if by some reason it doesn't work properly please submit the name using this endpoint.

Future work

  • Add support to names from other languages.
  • Add support to last names.
  • Suggest similar names.
  • Add names information about frequence rate, popularity, and rank.