prim-dns-server/README.md

# prim-dns:request (request-id, method, body)

The prim-dns script received an HTTP request.

## Parameters

- `request-id` The key of the request.
- `method` The HTTP method of the request.
- `body` The body of the request.

## Example

```lsl
link_message(integer sender, integer num, string str, key id)
{    
    if (llJsonGetValue(str, ["method"]) == "prim-dns:request")
    {   
        jsonrpc_link_notification(sender, "prim-dns:response", ["request-id", request_id, "status", 200, "body", "Hello, world!"]);
    }
}
```

# prim-dns:set-content-type (request-id, content-type)

Set the content type of the response.

## Parameters

- `request-id` The key of the request to set the response content type for.
- `content-type` One of the supported content type constants.

## Example

```lsl
string params = llList2Json(JSON_OBJECT, [
    "request-id", request_id,
    "content-type", CONTENT_TYPE_HTML
]);

string message = llList2Json(JSON_OBJECT, [
    "method", "prim-dns:set-content-type",
    "params", params
]);

llMessageLinked(LINK_THIS, 0, message, NULL_KEY);
```

# prim-dns:response (request-id, status, body)

Send the response.

## Parameters

- `request-id` The key of the request to respond to.
- `status` The HTTP status code of the response.
- `body` The body of the response.

## Example

```lsl
string params = llList2Json(JSON_OBJECT, [
    "request-id", request_id,
    "status", 200,
    "body", "Hello, world!"
]);

string message = llList2son(JSON_OBJECT, [
    "method", "prim-dns:response",
    "params", params
]);

llMessageLinked(LINK_THIS, 0, message, NULL_KEY);
```

# prim-dns:reboot ()

Reboot the prim-dns server.

## Example

```lsl
string message = llList2Json(JSON_OBJECT, [
    "method", "prim-dns:reboot"
]);

llMessageLinked(LINK_THIS, 0, message, NULL_KEY);
```

# prim-dns:shutdown ()

Shut down the prim-dns server.

## Example

```lsl
string message = llList2Json(JSON_OBJECT, [
    "method", "prim-dns:shutdown"
]);

llMessageLinked(LINK_THIS, 0, message, NULL_KEY);
```

# prim-dns:startup ()

Sent when the prim-dns server finishes reading the configuration and is waiting to continue starting up. If auto_start = 1, then the server will immediately continue, otherwise it will wait for the prim-dns:start messsage.

## Example

```lsl
link_message(integer sender, integer num, string str, key id)
{    
    if (llJsonGetValue(str, ["method"]) == "prim-dns:startup")
    {
        llOwnerSay("The prim-dns server is now waiting to start.");
    }
}
```

# prim-dns:start ()

Tell the prim-dns server to complete its startup.

## Example 

```lsl
string message = llList2Json(JSON_OBJECT, [
    "method", "prim-dns:start"
]);

llMessageLinked(LINK_THIS, 0, message, NULL_KEY);
```

# prim-dns:url-request-granted (url)

Sent when the prim-dns server is granted a temporary URL by the region.

## Parameters

- `url` The temporary URL assigned to the script.

## Example

```lsl
link_message(integer sender, integer num, string str, key id)
{    
    if (llJsonGetValue(str, ["method"]) == "prim-dns:url-request-granted")
    {        
        llOwnerSay("The prim-dns server was granted a URL: " + llJsonGetValue(str, ["params", "url"]));
    }
}
```

# prim-dns:alias-registered (alias)

Sent when the prim-dns server successfully registers or updates its alias.

## Parameters

- `alias` The endpoint URL of the registered alias.

## Example

```lsl
link_message(integer sender, integer num, string str, key id)
{
    if (llJsonGetValue(str, ["method"]) == "prim-dns:alias-registered")
    {
        llOwnerSay("The alias was successfully registered: " + llJsonGetValue(str, ["params", "alias"]));
    }
}
```