Partager via


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

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

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