Skip to content

API keys

Keys belong to a project. Open the project - API keys tab.

  1. Enter a Name (e.g. crawler-prod), choose Expires (30, 90, 180 days or 1 year) and optionally Allowed IPs (e.g. 203.0.113.0/24; empty = any address).
  2. Click New key. The full key (gsj_...) is shown once - copy it now. We store only a hash.

Default scopes: judge, reports:read. Use the key in the header Authorization: Bearer gsj_....

  • Rotate creates a new key; the old one keeps working during a grace period (7 days by default).
  • Revoke stops a key immediately.
  • The list shows status (grace period, expired, revoked) and when the key was last used.

API calls use the same monthly limit and balance as the panel. Next: API quickstart.