Powerspace API – Guide Développeur

Comment récupérer vos statistiques quotidiennes via l'API v4.

Informations clés :

• Base URL: https://api.powerspace.com
• Méthode: GET
• Format date: YYYY-MM-DD

1. Aperçu

GET /v4/advertiser

Récupère les statistiques pour une journée donnée. Les deux paramètres requis sont date et token.

📘

Note importante

Si aucune donnée n'est disponible pour la date demandée, l'API renvoie un tableau vide.

2. Authentification

Générez un API token depuis l'interface Powerspace (onglet API), puis transmettez-le en query string : ?token=<VOTRE_TOKEN>.

Bonnes pratiques :

• Stockez le token dans une variable d'environnement (ex. POWERS_API_TOKEN)
• Ne commitez jamais le token en clair dans un dépôt
• Révoquez et regénérez le token en cas d'exposition

3. Paramètres

4. Exemples d'appels

cURL

curl -s "https://api.powerspace.com/v4/advertiser?date=2025-10-13&token=${POWERS_API_TOKEN}"

Python (requests)

import os, requests

BASE_URL = "https://api.powerspace.com/v4/advertiser"
TOKEN = os.environ["POWERS_API_TOKEN"]

res = requests.get(BASE_URL, params={"date": "2025-10-13", "token": TOKEN}, timeout=30)
res.raise_for_status()
ct = res.headers.get("content-type", "")
print(res.json() if "application/json" in ct else res.text)

Node.js (fetch)

const base = 'https://api.powerspace.com/v4/advertiser';
const token = process.env.POWERS_API_TOKEN;

(async () => {
  const url = base + `?date=2025-10-13&token=${token}`;
  const r = await fetch(url);
  if (!r.ok) throw new Error(r.status + ' ' + r.statusText);
  const ct = r.headers.get('content-type') || '';
  console.log(ct.includes('application/json') ? await r.json() : await r.text());
})();

Bash – plage de dates

start=2025-10-01; end=2025-10-07
current=$start
while [ "$current" != "$(date -I -d "$end + 1 day")" ]; do
  url="https://api.powerspace.com/v4/advertiser?date=$current&token=$POWERS_API_TOKEN"
  echo Fetching $current... >&2
  curl -s "$url" > "stats_$current.json"
  current=$(date -I -d "$current + 1 day")
done

5. Structure des réponses

L'API peut renvoyer un JSON (statistiques de la journée)

6. Sécurité

• Stockez le token dans un secret (Vault, GitHub Actions, variables d'env. Docker, etc.)
• Appliquez le principe du moindre privilège
• Renouvelez et révoquez périodiquement les tokens inutilisés

7. Check-list mise en prod

• ✅ Token injecté via secret & variables d'environnement
• ✅ Validation stricte du format YYYY-MM-DD
• ✅ Gestion des cas sans données
• ✅ Journalisation et alerting sur erreurs ≥ 400
• ✅ Retries/backoff sur 429/5xx
• ✅ Tests d'intégration sur un échantillon de dates connues

Exemple prêt à l'emploi

export POWERS_API_TOKEN=<VOTRE_TOKEN>
curl -s "https://api.powerspace.com/v4/advertiser?date=$(date -I)&token=${POWERS_API_TOKEN}"