API & Webhooks

Intégrez Powalyze dans votre écosystème

Résumé

L'API REST de Powalyze permet d'automatiser vos workflows, synchroniser des données externes et recevoir des notifications en temps réel via webhooks.

1

Obtenir une clé API

1. Paramètres → Développeurs → API Keys

2. Cliquez sur "Créer une clé"

3. Définissez les permissions (Read, Write, Admin)

4. Copiez le token : pk_live_...

2

Effectuer votre premier appel

curl https://api.powalyze.com/v1/projects \
  -H "Authorization: Bearer pk_live_xxxxx" \
  -H "Content-Type: application/json"
  
// Réponse
{
  "data": [
    {
      "id": "prj_abc123",
      "name": "Transformation Digitale",
      "status": "in_progress",
      "health": "green"
    }
  ]
}
3

Configurer un Webhook

1. Paramètres → Webhooks

2. "+ Nouveau webhook"

3. URL de destination : https://votre-app.com/webhook

4. Événements à écouter :

  • project.created
  • risk.escalated
  • decision.approved
  • report.generated
4

Exemple d'automatisation

Scénario : Créer automatiquement un ticket Jira quand un risque devient critique

// Votre endpoint reçoit:
{
  "event": "risk.escalated",
  "data": {
    "id": "risk_xyz",
    "title": "Dépassement budget",
    "severity": "high",
    "project_id": "prj_abc123"
  }
}

// Votre code crée le ticket Jira
await jira.createIssue({
  fields: {
    project: { key: "PMO" },
    summary: data.title,
    priority: { name: "High" }
  }
});

Endpoints principaux

GET/v1/projects
POST/v1/projects
GET/v1/risks
PUT/v1/risks/:id
GET/v1/decisions
POST/v1/reports/generate