Ghid de inițiere rapidă Python

Acest ghid vă ghidează prin autentificarea la API-ul VaultPAM și efectuarea primei cereri folosind Python.

Condiții prealabile:

• Python 3.8 sau mai recent
• biblioteca requests: pip install requests
• Un cont VaultPAM cu acces API activat

---

Pasul 1 — Instalare biblioteca requests

pip install requests

---

Pasul 2 — Autentificare

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.")

Nu efectuați commit al token-urilor

Stocați token într-un manager de secrete sau într-o variabilă de mediu — nu codificați niciodată credențialele. Consultați Token Storage.

---

Pasul 3 — Obțineți organizația dvs. activă

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}")

---

Pasul 4 — Enumerați safes-urile dvs.

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'))}")

---

Exemplu complet

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)

---

Gestionare erori

raise_for_status() ridică requests.HTTPError la răspunsuri 4xx/5xx. Accesați exc.response.status_code și exc.response.text pentru detalii:

Cod	Semnificație
401 Unauthorized	Token-ul lipsește, a expirat sau este invalid. Re-autentificați-vă.
403 Forbidden	Token-ul nu are domeniul necesar pentru acest endpoint.
429 Too Many Requests	Limita de rată depășită. Verificați antetul retry-after.
500 Internal Server Error	Eroare tranzitorie a serverului. Reîncercați cu backoff.

---

Conștientizare limită de rată

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}")

Consultați Rate Limits pentru strategii de backoff.

---

Pași următori

• Authentication Flow — ciclu complet de token, PAT-uri și stocare secură
• curl Quickstart — același flux utilizând linia de comandă
• TypeScript Quickstart — același flux utilizând Node.js
• Rate Limits — înțelegerea antetelor x-ratelimit-*