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 |
| 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