NameAPI (Independent Publisher) (Preview)

NameAPI is a web API to handle people's names in your software.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Fördős András
Email	fordosa90+ipc_nameapi@gmail.com

Connector Metadata
Publisher	Fördős András
Website	https://www.nameapi.org/
Privacy policy	https://www.nameapi.org/en/legal/privacy-policy/
Categories	Data

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
API Key	securestring	The API Key for this api	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Detect disposable email address	Tells whether an email address is a disposable one.
Parse name	Parses a person's raw name, identifies the individual name parts.

Detect disposable email address

Operation ID:

DetectDea

Tells whether an email address is a disposable one.

Parameters

Name	Key	Required	Type	Description
Email address	emailAddress	True	string	A syntactically valid email address, example: 'DaDiDoo@mailinator.com'

Returns

Name	Path	Type	Description
Disposable	disposable	string	Indication, whether the email address is known to be disposable.

Parse name

Operation ID:

ParseName

Parses a person's raw name, identifies the individual name parts.

Parameters

Name	Key	Required	Type	Description
Person names	Person names		object
Gender	gender		string	The gender of the person.

Returns

Name	Path	Type	Description
Matches	matches	array of object	Array of matches.
Parsed person	matches.parsedPerson	ParsedPersonRef	Information about the person: the computed gender, the addressing given name, the addressing surname.
Parser disputes	matches.parserDisputes	ParserDisputesRef	A list of consistency problems detected by the parser is within this object.
Likeliness	matches.likeliness	ParserLikelinessRef	A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.
Confidence	matches.confidence	ParserConfidenceRef	A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.
Parsed person	bestMatch.parsedPerson	ParsedPersonRef	Information about the person: the computed gender, the addressing given name, the addressing surname.
Parser disputes	bestMatch.parserDisputes	ParserDisputesRef	A list of consistency problems detected by the parser is within this object.
Likeliness	bestMatch.likeliness	ParserLikelinessRef	A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.
Confidence	bestMatch.confidence	ParserConfidenceRef	A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.

Definitions

ParsedPersonRef

Information about the person: the computed gender, the addressing given name, the addressing surname.

Name	Path	Type	Description
Person type	personType	string	The type of person, it can be types of natural and legal people, and groups of them.
Person role	personRole	string	The role of the person. For example it can be the receiver, the owner or just a contact.
Mailing person roles	mailingPersonRoles	array of string	The roles of a person within a mailing address. It is of interest once not only a single, but multiple entities are mentioned.
Gender	gender.gender	string	The computed gender result.
Male proportion	gender.maleProportion	string	If the computed gender is neutral this may be specified (but does not have to be). A value 0-1, the remaining percentage is for the female gender.
Confidence	gender.confidence	float	A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.
Addressing given name	addressingGivenName	string	The given name that may be used when addressing the person.
Addressing surname	addressingSurname	string	The surname that may be used when addressing the person.
Terms	outputPersonName.terms	array of object	The list of extracted name related terms from the input person.
String	outputPersonName.terms.string	string	The string of the term.
Term type	outputPersonName.terms.termType	string	The type of the term.

ParserDisputesRef

A list of consistency problems detected by the parser is within this object.

Name	Path	Type	Description
Items		object

ParserLikelinessRef

A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.

A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.

Likeliness

float

ParserConfidenceRef

A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.

A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.

Confidence

float