Namsor
Namsor is a name-analysis API that infers attributes such as likely gender, cultural origin, and ethnicity from personal names.
- Base URL:
https://v2.namsor.com/NamSorAPIv2 - Auth:
header:X-API-KEY(pass your key via theapiKeyinput)
Operations
anonymize— GET /api2/json/anonymize/{source}/{anonymized}/{token} — Activate/deactivate anonymization for a source.apikeyinfo— GET /api2/json/apiKeyInfo — Read API Key info.availableservices— GET /api2/json/apiServices — List of classification services and usage cost in Units per classification (default is 1=ONE Unit). Some API endpoints (ex. Corridor) combine multiple classifiers.apistatus— GET /api2/json/apiStatus — Prints the current status of the classifiers. A classifier name in apiStatus corresponds to a service name in apiServices.apiusage— GET /api2/json/apiUsage — Print current API usage.apiusagehistory— GET /api2/json/apiUsageHistory — Print historical API usage.
Inputs
apiKey— your namsor API keyoperation— one of the operations above- path parameters when an operation's path contains
{...} query— optional JSON object of query paramsbody— JSON object for create/update ops
Example
operation: anonymize
apiKey: <your key>
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
erroroperationresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey |
string | yes | — | DEPRECATED — bind an API Key credential to the task with credentialName instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change. |
operation |
string | yes | — | One of: anonymize, apikeyinfo, availableservices, apistatus, apiusage, apiusagehistory |
anonymized |
string | no | — | Path parameter anonymized (required by some operations). |
source |
string | no | — | Path parameter source (required by some operations). |
token |
string | no | — | Path parameter token (required by some operations). |
query |
string | no | — | Query-string parameters as a JSON object string, e.g. {"limit": 50}. Parsed and url-encoded onto the request. |