Espace

Espace de la clé d’API, limites de l’offre et consommation

GET/v1/workspace

Authentification: Clé d’API (Authorization: Bearer)
Portée requise: read

Réponses#

200Espace.

En-têtes de réponse

RateLimit-Limitinteger
Requêtes permises par fenêtre.
RateLimit-Remaininginteger
Requêtes restantes dans la fenêtre en cours.
RateLimit-Resetinteger
Secondes avant la fenêtre suivante.
RateLimit-Policystring
Par exemple 10;w=1.
Aicscan-Daily-Quota-Limitinteger
Appels permis par jour UTC (offres avec quota quotidien).
Aicscan-Daily-Quota-Remaininginteger
Appels restants aujourd’hui (UTC).

Champs de l’objet

workspaceobject
Champs de l’objet
- idstring · uuid
- namestring
- planstring
- statestring
  Valeurs active suspended
- created_atstring · date-time
planobject
Champs de l’objet
- codestring
- namestring
limitsobject
Limites de l’offre de l’espace. null = illimité.
Champs de l’objet
- addressesintegerpeut valoir null
- rulesintegerpeut valoir null
- channelsintegerpeut valoir null
- channel_kindstableau de stringpeut valoir null
  null = tous les types.
- chainsintegerpeut valoir null
- requests_per_secondinteger
  Débit appliqué à cette clé.
- requests_per_dayintegerpeut valoir null
- immediate_alertboolean
usageobject
Champs de l’objet
- addressesinteger
- rulesinteger
- channelsinteger
- requests_todayinteger
  Appels servis aujourd’hui (UTC).
api_keyobject
Champs de l’objet
- idstring · uuid
- prefixstring
- scopestableau de string
  Valeurs read write

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl "https://aicscan.io/v1/workspace" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/workspace', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/workspace",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "workspace": {
    "id": "0193a1b2-0c1d-7e4f-8a9b-1c2d3e4f5a01",
    "name": "Acme Treasury",
    "plan": "pro",
    "state": "active",
    "created_at": "2026-10-02T08:00:00Z"
  },
  "plan": {
    "code": "pro",
    "name": "Pro"
  },
  "limits": {
    "addresses": 100,
    "rules": null,
    "channels": 10,
    "channel_kinds": null,
    "chains": null,
    "requests_per_second": 25,
    "requests_per_day": 10000,
    "immediate_alert": true
  },
  "usage": {
    "addresses": 12,
    "rules": 4,
    "channels": 3,
    "requests_today": 318
  },
  "api_key": {
    "id": "0193a1a0-77b1-7c3d-8e9f-0a1b2c3d4e5f",
    "prefix": "aic_k3J9xQ2a",
    "scopes": [
      "read",
      "write"
    ]
  }
}