NSns-api
Authentication/API Key (Machine 2 Machine)

Read Info on specific APIKey via Key ID

Changed on

This action will show apikeys that have been generated by your current APIkey and that you have access to update or revoke as needed.

Note: # and anything after is NOT needed, its just to allow multiple examples for the same path/method.

get/apikeys/{key_id}

Request

  • Base URL
    https://ns-api.com/ns-api/v2
  • URL
    https://ns-api.com/ns-api/v2/apikeys/{key_id}
  • Auth
    HTTP bearer

Path parameters

key_idstring required

Response

descriptionstring required

This is the main description/name for the API key that should describe its purpose for tracking and understanding its intended use.

key-idstring required

This is the Key ID that will identify the key and allow for managment, audit tracking and monitoring.

resellerstring required

This is the reseller that will limit the API key to access the resellers data set.

userstring

This is the main user extension for the user account.

domainstring required

This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. ~ and * can be used alone in special cases to mean My Domain (~) and All Domains (*).

user-scope'Basic User' | 'Simple User' | 'Advanced User' | 'Call Center Agent' | 'Call Center Supervisor' | 'Office Manager' | 'Reseller' | 'Super User' | 'NDP'

This is the scope that will be be used to enforce permissions for this API key and access.

ip-addressstring

Optional IP restrictions for API to require access from matching IP or subnets. Multipe ips/subnets can be provided comma seperated

readonly'yes' | 'no'

If enabled it will limit any get Scope to a read only verion providing only GET acces to the read actions. POST, PUT and DELETE will be rejected.

can-create-keys'yes' | 'no'

If enabled it will allow this key to make keys for lesser scopes then itself. It will not allow creations of scopes same or higher access level.

created-datetimestring date-time

The datetime that the key was created.

lastused-datetimestring date-time nullable

The datetime of the last time the apikey was used for API access. The timestamp is acurrate up to the hour to avoid overhead in tracking high volume requests

Example response

[
  {
    "description": "Used by Vendor Xyz for Billing Automation",
    "key-id": "nsd-123dsa23",
    "user": "1000",
    "domain": "example.com",
    "ip-address": "1.2.3.4,5.6.7.0/24"
  }
]

Changes

  • bce16087d479Revision changes
    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status