SSpiderIQ
SSpiderIQ

Docs / api-reference/notifications-public

notifications:public

2 endpoints from the published OpenAPI import.

GET/u/{token}

Unsubscribe Confirm

Confirmation landing page. NEVER mutates state — link-scanners that prefetch the URL must see only a page.

Parameters

NameInTypeRequiredDescription
tokenpathstringtrue
Try it
Query

Examples

cURL
curl -X GET 'https://spideriq.ai/u/{token}' \
  -H 'Authorization: Bearer <token>'
Python
import httpx

resp = httpx.get(
    "https://spideriq.ai/u/{token}",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())
JavaScript
const resp = await fetch("https://spideriq.ai/u/{token}", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);
Go
package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://spideriq.ai/u/{token}", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

StatusDescription
200Successful Response
422Validation Error
POST/u/{token}

Unsubscribe Apply

Apply the unsubscribe and record an audit row.

Idempotent: re-POSTing the same token flips already-FALSE rows to FALSE (no-op) and inserts a second audit row. Audit rows reflect user intents, not state transitions.

All DB work happens in ONE transaction so the audit row and the preference UPSERTs commit together.

Parameters

NameInTypeRequiredDescription
tokenpathstringtrue
Try it
Query

Examples

cURL
curl -X POST 'https://spideriq.ai/u/{token}' \
  -H 'Authorization: Bearer <token>'
Python
import httpx

resp = httpx.post(
    "https://spideriq.ai/u/{token}",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())
JavaScript
const resp = await fetch("https://spideriq.ai/u/{token}", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);
Go
package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("POST", "https://spideriq.ai/u/{token}", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

StatusDescription
200Successful Response
422Validation Error