Inicio rápido con Python

Esta guía le proporciona los pasos necesarios para autenticarse en la API de VaultPAM y realizar su primera solicitud usando Python.

Requisitos previos:

• Python 3.8 o posterior
• Librería requests: pip install requests
• Una cuenta de VaultPAM con acceso a API habilitado

---

Paso 1 — Instale la librería requests

pip install requests

---

Paso 2 — Autentíquese

import getpass
import os
import requests

BASE_URL = os.environ.get("VAULTPAM_BASE_URL", "https://api.vaultpam.com")

email = input("Email: ")
password = getpass.getpass("Password: ")  # Never commit credentials to source control

response = requests.post(
    f"{BASE_URL}/api/v1/auth/login",
    json={"email": email, "password": password},
)
response.raise_for_status()

auth_data = response.json()
# Never commit — see auth-flow.md#token-storage
token = auth_data["access_token"]
expires_in = auth_data["expires_in"]
print(f"Authenticated. Token expires in {expires_in} seconds.")

Nunca confirme tokens

Almacene token en un gestor de secretos o variable de entorno — nunca codifique credenciales. Consulte Almacenamiento de tokens.

---

Paso 3 — Obtenga su organización activa

org_response = requests.get(
    f"{BASE_URL}/api/v1/org/memberships",
    headers={"Authorization": f"Bearer {token}"},
)
org_response.raise_for_status()

org_data = org_response.json()
org_id = org_data["active_org_id"]
print(f"Active org: {org_id}")

---

Paso 4 — Liste sus Safes

safes_response = requests.get(
    f"{BASE_URL}/api/v1/safes",
    headers={
        "Authorization": f"Bearer {token}",
        "X-Active-Org-Id": org_id,
    },
)
safes_response.raise_for_status()

safes = safes_response.json()
print(f"Found {len(safes)} safe(s):")
for safe in safes:
    print(f"  - {safe.get('name', safe.get('id'))}")

---

Ejemplo completo

import getpass
import os
import sys
import requests

BASE_URL = os.environ.get("VAULTPAM_BASE_URL", "https://api.vaultpam.com")


def get_session(base_url: str) -> tuple[str, str]:
    """Authenticate and return (token, org_id)."""
    email = input("Email: ")
    password = getpass.getpass("Password: ")  # Never commit — see auth-flow.md#token-storage

    resp = requests.post(f"{base_url}/api/v1/auth/login", json={"email": email, "password": password})
    resp.raise_for_status()
    token = resp.json()["access_token"]

    org_resp = requests.get(f"{base_url}/api/v1/org/memberships", headers={"Authorization": f"Bearer {token}"})
    org_resp.raise_for_status()
    org_id = org_resp.json()["active_org_id"]

    return token, org_id


def list_safes(base_url: str, token: str, org_id: str) -> list:
    resp = requests.get(
        f"{base_url}/api/v1/safes",
        headers={"Authorization": f"Bearer {token}", "X-Active-Org-Id": org_id},
    )
    resp.raise_for_status()
    return resp.json()


if __name__ == "__main__":
    try:
        token, org_id = get_session(BASE_URL)
        safes = list_safes(BASE_URL, token, org_id)
        print(f"Safes ({len(safes)}):")
        for s in safes:
            print(f"  {s.get('name', s.get('id'))}")
    except requests.HTTPError as exc:
        print(f"API error {exc.response.status_code}: {exc.response.text}", file=sys.stderr)
        sys.exit(1)

---

Control de errores

raise_for_status() lanza requests.HTTPError en respuestas 4xx/5xx. Acceda a exc.response.status_code y exc.response.text para obtener detalles:

Código	Significado
401 Unauthorized	El token falta, ha caducado o no es válido. Vuelva a autenticarse.
403 Forbidden	El token carece del alcance requerido para este extremo.
429 Too Many Requests	Límite de velocidad excedido. Compruebe el encabezado retry-after.
500 Internal Server Error	Error temporal del servidor. Reintentar con retroceso.

---

Conciencia del límite de velocidad

response = requests.get(
    f"{BASE_URL}/api/v1/safes",
    headers={"Authorization": f"Bearer {token}", "X-Active-Org-Id": org_id},
)
remaining = response.headers.get("x-ratelimit-remaining")
print(f"Rate limit remaining: {remaining}")

Consulte Límites de velocidad para estrategias de retroceso.

---

Pasos siguientes

• Flujo de autenticación — ciclo de vida completo del token, PATs y almacenamiento seguro
• Inicio rápido con curl — el mismo flujo usando la línea de comandos
• Inicio rápido con TypeScript — el mismo flujo usando Node.js
• Límites de velocidad — comprenda los encabezados x-ratelimit-*