POST api/Zone/{zone_handle}/NsPubKey?user={user}
Create a new ns public key on a zone
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| zone_handle |
Handle of zone |
string |
Required |
| user |
Optional user handle - if empty logged in user will be used |
string |
None. |
Body Parameters
New ns public key details
NewNsPubKey| Name | Description | Type | Additional information |
|---|---|---|---|
| KeyTag | string |
Required |
|
| PubKey | string |
Required |
Request Formats
application/json, text/json
Sample:
{
"KeyTag": "sample string 1",
"PubKey": "sample string 2"
}
application/xml, text/xml
Sample:
<NewNsPubKey xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Zone"> <KeyTag>sample string 1</KeyTag> <PubKey>sample string 2</PubKey> </NewNsPubKey>
application/x-www-form-urlencoded
Sample:
Response Information
Resource Description
ns key object on success
Collection of errors on failure
Return codes
200 - ok
300 - ambiguous
401 - unauthorized
404 - not found
500 - internal server error
525 - object already registered
696 - Zone hosted by namebay
| Name | Description | Type | Additional information |
|---|---|---|---|
| Id | integer |
None. |
|
| ZoneName |
Name of the zone |
string |
None. |
| KeyTag | string |
None. |
|
| PubKey | string |
None. |
|
| DateInsert | date |
None. |
|
| NbNs |
Namebay hosted |
boolean |
None. |
Response Formats
application/json, text/json
Sample:
{
"Id": 1,
"ZoneName": "sample string 2",
"KeyTag": "sample string 3",
"PubKey": "sample string 4",
"DateInsert": "2025-12-12T19:16:11.670099+01:00",
"NbNs": true
}
application/xml, text/xml
Sample:
<NsPubKey xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models.Zone"> <DateInsert>2025-12-12T19:16:11.670099+01:00</DateInsert> <Id>1</Id> <KeyTag>sample string 3</KeyTag> <NbNs>true</NbNs> <PubKey>sample string 4</PubKey> <ZoneName>sample string 2</ZoneName> </NsPubKey>