Read the public knowledge base

curl -s "https://solnyxus.com/api/v1/kb/site/home"

const res = await fetch("https://solnyxus.com/api/v1/kb/site/home");
const home = await res.json();
console.log(home.featured.map((a) => a.title));

import requests

res = requests.get("https://solnyxus.com/api/v1/kb/site/home", timeout=30)
for a in res.json()["featured"]:
    print(a["title"])

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	res, err := http.Get("https://solnyxus.com/api/v1/kb/site/home")
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var home struct {
		Featured []struct{ Title string }
	}
	json.NewDecoder(res.Body).Decode(&home)
	for _, a := range home.Featured {
		fmt.Println(a.Title)
	}
}

curl -s "https://solnyxus.com/api/v1/kb/site/articles?kind=api&level=beginner&page=1"

const params = new URLSearchParams({ kind: "api", level: "beginner", page: "1" });
const res = await fetch(`https://solnyxus.com/api/v1/kb/site/articles?${params}`);
const list = await res.json();
console.log(list.total, "articles;", list.items.map((a) => a.slug));

import requests

res = requests.get(
    "https://solnyxus.com/api/v1/kb/site/articles",
    params={"kind": "api", "level": "beginner", "page": 1},
    timeout=30,
)
data = res.json()
print(data["total"], "articles;", [a["slug"] for a in data["items"]])

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
)

func main() {
	q := url.Values{"kind": {"api"}, "level": {"beginner"}, "page": {"1"}}
	res, err := http.Get("https://solnyxus.com/api/v1/kb/site/articles?" + q.Encode())
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var list struct {
		Total int
		Items []struct{ Slug string }
	}
	json.NewDecoder(res.Body).Decode(&list)
	fmt.Println(list.Total, "articles")
	for _, a := range list.Items {
		fmt.Println(a.Slug)
	}
}

curl -s "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call"

const res = await fetch("https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call");
if (res.status === 404) throw new Error("no such article");
const { article, prerequisites } = await res.json();
console.log(article.title, "needs", prerequisites.length, "other articles first");

import requests

res = requests.get(
    "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call",
    timeout=30,
)
res.raise_for_status()
data = res.json()
print(data["article"]["title"], "needs", len(data["prerequisites"]), "other articles first")

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	res, err := http.Get("https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call")
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	if res.StatusCode == http.StatusNotFound {
		panic("no such article")
	}
	var data struct {
		Article       struct{ Title string }
		Prerequisites []struct{ Slug string }
	}
	json.NewDecoder(res.Body).Decode(&data)
	fmt.Println(data.Article.Title, len(data.Prerequisites))
}

curl -s "https://solnyxus.com/api/v1/kb/site/tags"

const res = await fetch("https://solnyxus.com/api/v1/kb/site/tags");
for (const t of await res.json()) console.log(t.key, t.count);

import requests

res = requests.get("https://solnyxus.com/api/v1/kb/site/tags", timeout=30)
for t in res.json():
    print(t["key"], t["count"])

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	res, err := http.Get("https://solnyxus.com/api/v1/kb/site/tags")
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var tags []struct {
		Key   string
		Count int
	}
	json.NewDecoder(res.Body).Decode(&tags)
	for _, t := range tags {
		fmt.Println(t.Key, t.Count)
	}
}

curl -s "https://solnyxus.com/api/v1/kb/site/search?q=first+ticket"

const res = await fetch("https://solnyxus.com/api/v1/kb/site/search?q=" + encodeURIComponent("first ticket"));
const { articles, posts } = await res.json();
console.log(articles.length, "articles,", posts.length, "posts");

import requests

res = requests.get(
    "https://solnyxus.com/api/v1/kb/site/search",
    params={"q": "first ticket"},
    timeout=30,
)
data = res.json()
print(len(data["articles"]), "articles,", len(data["posts"]), "posts")

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
)

func main() {
	res, err := http.Get("https://solnyxus.com/api/v1/kb/site/search?q=" + url.QueryEscape("first ticket"))
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var out struct {
		Articles []struct{ Slug string }
		Posts    []struct{ Slug string }
	}
	json.NewDecoder(res.Body).Decode(&out)
	fmt.Println(len(out.Articles), "articles,", len(out.Posts), "posts")
}

curl -s -X POST "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/feedback" \
  -H "Content-Type: application/json" -d '{"helpful":true}'

const res = await fetch(
  "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/feedback",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ helpful: true }),
  },
);
const totals = await res.json();
console.log(res.status, totals.helpful, totals.notHelpful);

import requests

res = requests.post(
    "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/feedback",
    json={"helpful": True},
    timeout=30,
)
totals = res.json()
print(res.status_code, totals["helpful"], totals["notHelpful"])

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"strings"
)

func main() {
	url := "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/feedback"
	res, err := http.Post(url, "application/json", strings.NewReader(`{"helpful":true}`))
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var totals struct{ Helpful, NotHelpful int }
	json.NewDecoder(res.Body).Decode(&totals)
	fmt.Println(res.StatusCode, totals.Helpful, totals.NotHelpful)
}

curl -s -X POST "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/suggestions" \
  -H "Content-Type: application/json" \
  -d '{"problem":"Step 2 names a button the page no longer has.","proposal":"Select Send, then read the answer.","email":"you@example.com"}'

const res = await fetch(
  "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/suggestions",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      problem: "Step 2 names a button the page no longer has.",
      proposal: "Select Send, then read the answer.",
      email: "you@example.com",
    }),
  },
);
if (res.status === 429) console.log("try again in", res.headers.get("Retry-After"), "seconds");
else console.log(res.status, (await res.json()).status);

import requests

res = requests.post(
    "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/suggestions",
    json={
        "problem": "Step 2 names a button the page no longer has.",
        "proposal": "Select Send, then read the answer.",
        "email": "you@example.com",
    },
    timeout=30,
)
if res.status_code == 429:
    print("try again in", res.headers["Retry-After"], "seconds")
else:
    print(res.status_code, res.json()["status"])

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"strings"
)

func main() {
	url := "https://solnyxus.com/api/v1/kb/site/articles/your-first-api-call/suggestions"
	body := `{"problem":"Step 2 names a button the page no longer has.","proposal":"Select Send, then read the answer.","email":"you@example.com"}`
	res, err := http.Post(url, "application/json", strings.NewReader(body))
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	if res.StatusCode == http.StatusTooManyRequests {
		fmt.Println("try again in", res.Header.Get("Retry-After"), "seconds")
		return
	}
	var out struct{ Status string }
	json.NewDecoder(res.Body).Decode(&out)
	fmt.Println(res.StatusCode, out.Status)
}

curl -s "https://solnyxus.com/api/v1/kb/read/me" -H "Authorization: Bearer $TOKEN"

import { env } from "node:process";

const res = await fetch("https://solnyxus.com/api/v1/kb/read/me", {
  headers: { Authorization: `Bearer ${env.TOKEN}` },
});
const me = await res.json();
console.log(me.signedIn ? `${me.reader.name} (${me.via})` : "reading as the public web");

import os
import requests

res = requests.get(
    "https://solnyxus.com/api/v1/kb/read/me",
    headers={"Authorization": f"Bearer {os.environ['TOKEN']}"},
    timeout=30,
)
me = res.json()
print(me["reader"]["name"] if me["signedIn"] else "reading as the public web")

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://solnyxus.com/api/v1/kb/read/me", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("TOKEN"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var me struct {
		SignedIn bool
		Via      string
		Reader   struct{ Name, Client string }
	}
	json.NewDecoder(res.Body).Decode(&me)
	fmt.Println(me.SignedIn, me.Via, me.Reader.Name, me.Reader.Client)
}