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, statut Enabled), 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

Nom	Type	Obligatoire	Exemple	Notes
`date`	string	Oui	`2025-10-13`	Format ISO 8601 `YYYY-MM-DD`. Par défaut, considérez UTC.
`token`	string	Oui	`********`	Token API généré dans l'interface.

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. Erreurs & diagnostics

Code	Signification probable	Pistes
🟢 200	OK	Données ou message textuel.
🟢 204	No Content	Pas de données (selon implémentation).
🟡 400	Bad Request	Format de `date` invalide.
🔴 401/403	Auth/Forbidden	Token absent, invalide, révoqué.
🟡 404	Not Found	Endpoint ou méthode incorrects.
🟡 429	Too Many Requests	Attendre et réessayer (backoff exponentiel).
🔴 5xx	Erreur serveur	Réessayer avec backoff. Journaliser l'incident.

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

8. 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}"