API des crédits

API des crédits #

Surveillez votre solde de crédits et votre historique d’utilisation grâce à l’API.

Obtenir le solde de crédits #

Point de terminaison : GET /api/v1/credits

curl -X GET "https://app.voxpria.com/api/v1/credits" 
  -H "Authorization: Bearer YOUR_API_KEY"

Réponse #

{
  "success": true,
  "data": {
    "balance": 1500,
    "currency": "credits",
    "lastUpdated": "2025-02-09T12:00:00Z"
  }
}

Obtenir l’historique d’utilisation #

Point de terminaison : GET /api/v1/credits/usage

curl -X GET "https://app.voxpria.com/api/v1/credits/usage?startDate=2025-02-01&endDate=2025-02-09" 
  -H "Authorization: Bearer YOUR_API_KEY"

Réponse #

{
  "success": true,
  "data": {
    "usage": [
      {
        "date": "2025-02-09",
        "calls": 45,
        "creditsUsed": 135,
        "cost": "$13.50"
      },
      {
        "date": "2025-02-08",
        "calls": 38,
        "creditsUsed": 114,
        "cost": "$11.40"
      }
    ],
    "total": {
      "calls": 83,
      "creditsUsed": 249,
      "cost": "$24.90"
    }
  }
}

Coûts en crédits #

Exemple de code #

JavaScript #

async function checkCredits() {
  const response = await axios.get(
    'https://app.voxpria.com/api/v1/credits',
    {
      headers: {
        'Authorization': `Bearer ${process.env.VOXPRIA_API_KEY}`
      }
    }
  );
  
  const balance = response.data.data.balance;
  console.log(`Current balance: ${balance} credits`);
  
  // Alert if low
  if (balance < 100) {
    console.warn('⚠️ Low credit balance!');
  }
  
  return balance;
}

Python #

def check_credits():
    response = requests.get(
        'https://app.voxpria.com/api/v1/credits',
        headers={
            'Authorization': f'Bearer {os.getenv("VOXPRIA_API_KEY")}'
        }
    )
    
    balance = response.json()['data']['balance']
    print(f'Current balance: {balance} credits')
    
    # Alert if low
    if balance < 100:
        print('⚠️ Low credit balance!')
    
    return balance

Surveillance de l'utilisation #

Configurez une surveillance automatisée :

• Vérifiez le solde avant de lancer des campagnes
• Recevez une alerte lorsque les crédits passent sous un seuil
• Suivez les tendances d'utilisation dans le temps
• Prévoyez le budget selon les tendances d'utilisation