Aller au contenu
AtheronDEVELOPERS

API reference

Every endpoint of Sign in with Atheron, the developer API and the MCP server.

Connectez-vous pour voir votre propre ID client de test dans les exemples.

Sign in with Atheron is standard OpenID Connect, under https://accounts.aton-network.org. The developer API and the MCP server are under https://developers.aton-network.org. Read the discovery document rather than hard-coding addresses. The whole surface is also an OpenAPI document.

Sign in with Atheron (OpenID Connect)

EndpointMethodPathWhat it does
Discovery documentGET/.well-known/openid-configurationWhere every other endpoint is, and what the provider supports: scopes, claims, grants, algorithms and client authentication methods.
Signing keys (JWKS)GET/.well-known/jwks.jsonThe public keys that sign ID tokens and access tokens, as a JSON Web Key Set.
AuthorizeGET/oauth/authorizeThe page you send somebody to. They sign in, see what you ask for, and come back to your redirect address with a one-time code.
Token: swap a codePOST/oauth/tokenSwaps the code from the redirect for an ID token, an access token and, with offline_access, a refresh token.
Token: refreshPOST/oauth/tokenSwaps a refresh token for a new access token and a new refresh token. The old refresh token stops working.
UserinfoGET, POST/oauth/userinfoWho the person is as of now: the claims their consent allows, read fresh from their account.
RevokePOST/oauth/revokeEnds a refresh token and every token in its line.

Developer API and MCP

EndpointMethodPathWhat it does
Developer API: your appGET/api/v1/appThe application and environment your API key belongs to: its client ID, redirect addresses, scopes, approved scopes and counts.
Developer API: usageGET/api/v1/usageCalls, errors and latency per day and bucket for your key's environment.
Developer API: events streamGET/api/v1/eventsYour app's events as Server-Sent Events, the same events and the same bodies as its webhooks, in order, resumable for 30 days.
MCP serverPOST/mcpThe Model Context Protocol server your AI tools connect to: the docs, the reference, examples by language, error lookup, the changelog, status, and, with a key, your app's settings, usage and sandbox calls.

Client authentication at the token endpoint

MethodHow
client_secret_basicHTTP Basic with client ID and secret (preferred)
client_secret_postclient_id and client_secret in the form
private_key_jwtclient_assertion_type and a client_assertion signed with your certificate's key; see Secrets and certificates
nonePublic apps: client_id in the form, PKCE only

Demandez à Atlas

Assistant IA

Posez n'importe quelle question sur Se connecter avec Atheron, l'API ou le portail. La réponse vient de notre documentation, avec les liens des pages utilisées.