Implement review suggestions

api/config.go

@@ -64,7 +64,7 @@ func registerConfig() error {
 	err = config.Register(&config.Option{
 		Name:           "API Keys",
 		Key:            CfgAPIKeys,
-		Description:    "Defined API Keys.",
+		Description:    "Define API keys for priviledged access to the API. Every entry is a separate API key with respective permissions. Format is `<key>?read=<perm>&write=<perm>`. Permissions are `anyone`, `user` and `admin`, and may be omitted.",
 		OptType:        config.OptTypeStringArray,
 		ExpertiseLevel: config.ExpertiseLevelDeveloper,
 		ReleaseLevel:   config.ReleaseLevelStable,

api/endpoints.go

@@ -41,6 +41,7 @@ type Endpoint struct {
 	HandlerFunc http.HandlerFunc `json:"-"`
 
 	// Documentation Metadata.
+
 	Name        string
 	Description string
 	Parameters  []Parameter

api/endpoints_debug.go

@@ -11,6 +11,16 @@ import (
 )
 
 func registerDebugEndpoints() error {
+	if err := RegisterEndpoint(Endpoint{
+		Path:        "ping",
+		Read:        PermitAnyone,
+		ActionFunc:  ping,
+		Name:        "Ping",
+		Description: "Pong.",
+	}); err != nil {
+		return err
+	}
+
 	if err := RegisterEndpoint(Endpoint{
 		Path:        "debug/stack",
 		Read:        PermitAnyone,
@@ -50,6 +60,11 @@ func registerDebugEndpoints() error {
 	return nil
 }
 
+// ping responds with pong.
+func ping(ar *Request) (msg string, err error) {
+	return "Pong.", nil
+}
+
 // getStack returns the current goroutine stack.
 func getStack(_ *Request) (data []byte, err error) {
 	buf := &bytes.Buffer{}

api/endpoints_meta.go

@@ -7,16 +7,6 @@ import (
 )
 
 func registerMetaEndpoints() error {
-	if err := RegisterEndpoint(Endpoint{
-		Path:        "ping",
-		Read:        PermitAnyone,
-		ActionFunc:  ping,
-		Name:        "Ping",
-		Description: "Pong.",
-	}); err != nil {
-		return err
-	}
-
 	if err := RegisterEndpoint(Endpoint{
 		Path:        "endpoints",
 		Read:        PermitAnyone,
@@ -94,10 +84,6 @@ func permissions(ar *Request) (i interface{}, err error) {
 	}, nil
 }
 
-func ping(ar *Request) (msg string, err error) {
-	return "Pong.", nil
-}
-
 func authBearer(w http.ResponseWriter, r *http.Request) {
 	// Check if authenticated by checking read permission.
 	ar := GetAPIRequest(r)