Aegis Developer Portal

Developer Search

Press ⌘K or Ctrl+K to jump through guides and API endpoint docs.

Examples

Runnable Examples

Reference snippets for common API consumption tasks. Use these as smoke-test baselines in CI and onboarding.

TypeScript: Create Session

const response = await fetch(
  baseUrl + "/aegis.v1.IdentityGatewayService/CreateSession",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer " + accessToken,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ email, password }),
  }
);

Go: Create Session

reqBody := strings.NewReader(`{"email":"dev@company.com","password":"<redacted>"}`)
req, _ := http.NewRequest(http.MethodPost, baseURL+"/aegis.v1.IdentityGatewayService/CreateSession", reqBody)
req.Header.Set("Authorization", "Bearer "+accessToken)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)

Bash: Create Session

curl -sS -X POST "$API_BASE/aegis.v1.IdentityGatewayService/CreateSession" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email":"dev@company.com","password":"<redacted>"}'

Usage Notes

Always send bearer auth and JSON content-type for protected JSON APIs.
Handle validation and permission errors explicitly in client code.
Verify failure-path behavior as strictly as success-path behavior.
Keep access tokens short-lived and avoid unnecessary persistence.