Nationalize.io (Independent Publisher) (#1688)
This commit is contained in:
Tomasz Poszytek
GitHub
Родитель
a9a21686f2
Коммит
cb780e83dc
|
|
@ -0,0 +1,20 @@
|
||||||
|
# Nationalize.io
|
||||||
|
Nationalize.io predicts the nationality of a person given their name. Use the API for analytics, ad segmenting, demographic statistics etc. The API is free for up to 1000 names/day.
|
||||||
|
|
||||||
|
## Publisher: Tomasz Poszytek
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
No prerequisites.
|
||||||
|
|
||||||
|
## Supported Operations
|
||||||
|
### Check name(s) nationality
|
||||||
|
Action returns predicted nationalities for a given name or list of names. In case you want to check nationality for a list of names, provide them delimited with comma. Max. 10 names at a time! List will be truncated to first 10 items in case more names are provided.
|
||||||
|
|
||||||
|
## Obtaining Credentials
|
||||||
|
If you would like to use the free version of API (up to 1000 names per day) just type **"none"** (w/o quotes) as the API key, when creating a connection. However, if you would like to check more than 1k names per month, please check subscription plans: https://store.nationalize.io/.
|
||||||
|
|
||||||
|
## Known Issues and Limitations
|
||||||
|
No issues or limitations at the moment of api creation.
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
Visit https://nationalize.io/ to test the api on your own.
|
||||||
|
|
@ -0,0 +1,136 @@
|
||||||
|
{
|
||||||
|
"swagger": "2.0",
|
||||||
|
"info": {
|
||||||
|
"title": "Nationalize_io",
|
||||||
|
"description": "Nationalize.io predicts the nationality of a person given their name. Use the API for analytics, ad segmenting, demographic statistics etc. The API is free for up to 1000 names/day.",
|
||||||
|
"version": "1.0",
|
||||||
|
"contact": {
|
||||||
|
"name": "Tomasz Poszytek",
|
||||||
|
"url": "https://aka.ms/poszytek",
|
||||||
|
"email": "tomasz@poszytek.eu"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"x-ms-connector-metadata": [
|
||||||
|
{
|
||||||
|
"propertyName": "Website",
|
||||||
|
"propertyValue": "https://nationalize.io/"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"propertyName": "Privacy policy",
|
||||||
|
"propertyValue": "https://nationalize.io/"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"propertyName": "Categories",
|
||||||
|
"propertyValue": "AI;Data"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"host": "api.genderize.io",
|
||||||
|
"basePath": "/",
|
||||||
|
"schemes": [
|
||||||
|
"https"
|
||||||
|
],
|
||||||
|
"consumes": ["application/json"],
|
||||||
|
"produces": ["application/json"],
|
||||||
|
"paths": {
|
||||||
|
"/": {
|
||||||
|
"get": {
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "200",
|
||||||
|
"schema": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Checked name.",
|
||||||
|
"title": "Name",
|
||||||
|
"x-ms-visibility": "important"
|
||||||
|
},
|
||||||
|
"country": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"country_id": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Country ISO code.",
|
||||||
|
"title": "Name"
|
||||||
|
},
|
||||||
|
"probability": {
|
||||||
|
"type": "number",
|
||||||
|
"format": "float",
|
||||||
|
"description": "The certainty of the assigned nationality.",
|
||||||
|
"title": "Probability"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"description": "List of checked countries.",
|
||||||
|
"title": "Countries"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"headers": {
|
||||||
|
"X-Rate-Limit-Limit": {
|
||||||
|
"description": "The amount of names available in the current time window",
|
||||||
|
"type": "integer",
|
||||||
|
"x-ms-visibility": "advanced"
|
||||||
|
},
|
||||||
|
"X-Rate-Reset": {
|
||||||
|
"description": "The number of names left in the current time window ",
|
||||||
|
"type": "integer",
|
||||||
|
"x-ms-visibility": "advanced"
|
||||||
|
},
|
||||||
|
"X-Rate-Limit-Remaining": {
|
||||||
|
"description": "Seconds remaining until a new time window opens",
|
||||||
|
"type": "integer",
|
||||||
|
"x-ms-visibility": "advanced"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"summary": "Check name(s) nationality",
|
||||||
|
"description": "Check nationality of a single name or multiple names. For multiple names - separate them with comma.",
|
||||||
|
"operationId": "CheckNamesNationality",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"name": "name",
|
||||||
|
"in": "query",
|
||||||
|
"required": true,
|
||||||
|
"type": "string",
|
||||||
|
"description": "Name(s) to check the nationality. For multiple, separate with comma. Up to 10 names at a time.",
|
||||||
|
"x-ms-summary": "Name(s)",
|
||||||
|
"x-ms-visibility": "important"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "Accept",
|
||||||
|
"in": "header",
|
||||||
|
"required": true,
|
||||||
|
"type": "string",
|
||||||
|
"default": "application/json",
|
||||||
|
"x-ms-visibility": "internal"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/m/": {}
|
||||||
|
},
|
||||||
|
"definitions": {},
|
||||||
|
"parameters": {},
|
||||||
|
"responses": {},
|
||||||
|
"securityDefinitions": {
|
||||||
|
"API Key": {
|
||||||
|
"type": "apiKey",
|
||||||
|
"in": "query",
|
||||||
|
"name": "apikey"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"API Key": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"tags": []
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,27 @@
|
||||||
|
{
|
||||||
|
"properties": {
|
||||||
|
"connectionParameters": {
|
||||||
|
"api_key": {
|
||||||
|
"type": "securestring",
|
||||||
|
"uiDefinition": {
|
||||||
|
"displayName": "Provide your API key. Type \"none\" if you are using free plan.",
|
||||||
|
"description": "Provide your API key. Type \"none\" if you are using free plan.",
|
||||||
|
"tooltip": "Provide your API key. Type \"none\" if you are using free plan.",
|
||||||
|
"constraints": {
|
||||||
|
"tabIndex": 2,
|
||||||
|
"clearText": false,
|
||||||
|
"required": "true"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"iconBrandColor": "#da3b01",
|
||||||
|
"scriptOperations": [
|
||||||
|
"CheckNamesNationality"
|
||||||
|
],
|
||||||
|
"capabilities": [],
|
||||||
|
"policyTemplateInstances": [],
|
||||||
|
"publisher": "Tomasz Poszytek",
|
||||||
|
"stackOwner": "nationalize.io"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,60 @@
|
||||||
|
using System.Net;
|
||||||
|
using System.Web;
|
||||||
|
|
||||||
|
public class Script : ScriptBase
|
||||||
|
{
|
||||||
|
|
||||||
|
public override async Task<HttpResponseMessage> ExecuteAsync()
|
||||||
|
{
|
||||||
|
return await this.HandleForwardOperation().ConfigureAwait(false);
|
||||||
|
}
|
||||||
|
|
||||||
|
private async Task<HttpResponseMessage> HandleForwardOperation()
|
||||||
|
{
|
||||||
|
// get current request Uri
|
||||||
|
var strRequestUri = this.Context.Request.RequestUri.AbsoluteUri;
|
||||||
|
/*
|
||||||
|
* url?name=x&country_id=y&apikey=z
|
||||||
|
* after split:
|
||||||
|
* 0: url
|
||||||
|
* 1: name
|
||||||
|
* 2: apikey
|
||||||
|
*/
|
||||||
|
string[] parts = strRequestUri.ToString().Split(new char[] {'?','&'});
|
||||||
|
|
||||||
|
int noOfParts = parts.Count();
|
||||||
|
|
||||||
|
// init request Uri params
|
||||||
|
string reqName = "";
|
||||||
|
string reqApiKey= "";
|
||||||
|
|
||||||
|
// build a request string for names
|
||||||
|
string[] reqNameParts = parts[1].Split('=');
|
||||||
|
string[] reqNames = (HttpUtility.UrlDecode(reqNameParts[1])).Split(',');
|
||||||
|
int loopNo = 0;
|
||||||
|
foreach (string reqNamePart in reqNames)
|
||||||
|
{
|
||||||
|
reqName = reqName + "name[]=" + reqNamePart.Trim() + "&";
|
||||||
|
loopNo++;
|
||||||
|
// Max. 10 names
|
||||||
|
if (loopNo == 10) break;
|
||||||
|
}
|
||||||
|
// remove last &
|
||||||
|
reqName = reqName.Remove(reqName.Length-1);
|
||||||
|
|
||||||
|
reqApiKey = "&"+parts[2];
|
||||||
|
// if api key is none - remove it from the request URI,
|
||||||
|
// to make a free request, otherwise use apikey
|
||||||
|
string[] reqApiKeyParts = reqApiKey.Split('=');
|
||||||
|
if (reqApiKeyParts[1].Contains("none")) {
|
||||||
|
reqApiKey = "";
|
||||||
|
}
|
||||||
|
|
||||||
|
// change request Uri in the request object
|
||||||
|
this.Context.Request.RequestUri = new Uri($"https://api.nationalize.io/?{reqName+reqApiKey}");
|
||||||
|
|
||||||
|
// Use the context to an HTTP request
|
||||||
|
HttpResponseMessage response = await this.Context.SendAsync(this.Context.Request, this.CancellationToken).ConfigureAwait(continueOnCapturedContext: false);
|
||||||
|
return response;
|
||||||
|
}
|
||||||
|
}
|
||||||
Загрузка…
Ссылка в новой задаче