API Keys

Endpoint público para crear API keys. No requiere autenticación, pero tiene límite de tasa.

Crear API Key

POST /public/api-keys

Crea una API key (rol estándar, expira en 6 meses). Usa la URL base de testnet o mainnet según la red que necesites.

• Testnet: https://api.testnet.acta.build/public/api-keys
• Mainnet: https://api.mainnet.acta.build/public/api-keys

Límite de tasa: 5 solicitudes por minuto por IP

Cuerpo de solicitud:

{
  "name": "Mi API Key",
  "wallet_address": "G...",
  "metadata": {
    "network": "testnet"
  }
}

Incluye metadata.network: "testnet" o "mainnet" según la URL base que uses.

Respuesta:

{
  "message": "API key creada exitosamente. Guarda esta key - no se mostrará de nuevo.",
  "api_key": "cadena hex de 64 caracteres",
  "api_key_record": {
    "id": "uuid",
    "name": "Mi API Key",
    "role": "standard",
    "is_active": true,
    "expires_at": "2024-07-01T00:00:00.000Z",
    "created_at": "2024-01-01T00:00:00.000Z"
  }
}

Ejemplo (testnet):

curl -X POST https://api.testnet.acta.build/public/api-keys \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Key de Testnet",
    "wallet_address": "G...",
    "metadata": {
      "network": "testnet"
    }
  }'

Ejemplo (mainnet):

curl -X POST https://api.mainnet.acta.build/public/api-keys \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Key de Mainnet",
    "wallet_address": "G...",
    "metadata": {
      "network": "mainnet"
    }
  }'

Cuerpo de solicitud

• name (opcional): Nombre para la API key (máx 120 caracteres)
• wallet_address (opcional): Dirección de wallet Stellar (G...)
• metadata (opcional): Objeto de metadatos adicionales
  • network (requerido): "testnet" o "mainnet"

Respuesta

• api_key: La API key - una cadena hex de 64 caracteres sin prefijo (guarda esto - no se mostrará de nuevo)
• api_key_record: Metadatos sobre la key creada

Una key por wallet: crear una key de nuevo para la misma wallet la rota - la key anterior se revoca y se reemplaza. metadata.network debe coincidir con la red de la URL base que llamas; si no coincide, devuelve 400 network_mismatch.

Límites de tasa

• Máximo 5 solicitudes por minuto por dirección IP
• Headers de límite de tasa incluidos en la respuesta:
  • X-RateLimit-Limit: 5
  • X-RateLimit-Remaining: Solicitudes restantes
  • X-RateLimit-Reset: Timestamp Unix cuando se reinicia el límite

Nota: La creación de API keys mediante estos endpoints está restringida por una lista de orígenes permitidos (https://dapp.acta.build, más localhost para desarrollo); otros orígenes reciben 403 forbidden_origin. Para la mejor experiencia, recomendamos usar la dApp de ACTA para crear y gestionar tus API keys.