Intégrez AMPA à votre plateforme

curl -X POST https://ampamail.com/api/v1/emails/send \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@votre-domaine.dz",
    "from_name": "Mon École",
    "to": ["parent@example.com"],
    "subject": "Bienvenue {{ prenom }} !",
    "html": "<p>Bonjour {{ prenom }}, votre compte est prêt.</p>",
    "variables": {"prenom": "Amina"}
  }'

Authorization: Bearer ampa_live_xxxxxxxxxxxxxxxxxxxxxxxx
# ou
X-API-Key: ampa_live_xxxxxxxxxxxxxxxxxxxxxxxx

HTTP/1.1 202 Accepted
{
  "results": [
    { "to": "parent@example.com", "id": "8f2c1a4e-5b1d-4f7a-9c33-2a6e0d1b7c90", "status": "queued" }
  ]
}

curl -X POST https://ampamail.com/api/v1/emails/send \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@votre-domaine.dz",
    "to": ["eleve@example.com"],
    "template_id": "3b9d6f0e-1c2a-4e8b-a7f5-6d4c2b1a0e99",
    "variables": {"prenom": "Karim", "code": "451236"}
  }'

curl -X POST https://ampamail.com/api/v1/emails/send \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE" \
  -H "Idempotency-Key: facture-2026-00451" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

# Un email précis
curl https://ampamail.com/api/v1/emails/8f2c1a4e-5b1d-4f7a-9c33-2a6e0d1b7c90 \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE"

# Les 20 derniers échecs
curl "https://ampamail.com/api/v1/emails?status=failed&limit=20" \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE"

{
  "id": "8f2c1a4e-5b1d-4f7a-9c33-2a6e0d1b7c90",
  "to": "parent@example.com",
  "from": "Mon École <noreply@votre-domaine.dz>",
  "subject": "Bienvenue Amina !",
  "status": "sent",
  "error": null,
  "created_at": "2026-10-09T14:02:11.402Z",
  "sent_at": "2026-10-09T14:02:12.918Z"
}

curl -X PUT https://ampamail.com/api/v1/audience/contacts \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "parent@example.com",
    "first_name": "Amina",
    "last_name": "Benali",
    "phone": "+213555123456",
    "custom_fields": {"classe": "6e A", "eleve": "Yacine"},
    "groups": ["Parents d’élèves", "Rentrée 2026"]
  }'

{
  "created": true,
  "contact": {
    "id": "c1e0b6a2-…",
    "email": "parent@example.com",
    "first_name": "Amina",
    "last_name": "Benali",
    "phone": "+213555123456",
    "status": "subscribed",
    "custom_fields": {"classe": "6e A", "eleve": "Yacine"},
    "groups": ["Parents d’élèves", "Rentrée 2026"],
    "created_at": "2026-10-09T14:05:40Z",
    "updated_at": "2026-10-09T14:05:40Z"
  }
}

curl -X POST https://ampamail.com/api/v1/audience/contacts/batch \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {"email": "prof.math@example.com", "first_name": "Karim", "groups": ["Enseignants"]},
      {"email": "secretariat@example.com", "groups": ["Administration"]}
    ]
  }'

# Réponse : {"created": 2, "updated": 0, "total": 2}

# La personne s’est désabonnée depuis votre plateforme
curl -X POST https://ampamail.com/api/v1/audience/contacts/parent@example.com/unsubscribe \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE"

# Consulter un contact
curl https://ampamail.com/api/v1/audience/contacts/parent@example.com \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE"

# Supprimer un contact (droit à l’effacement)
curl -X DELETE https://ampamail.com/api/v1/audience/contacts/parent@example.com \
  -H "Authorization: Bearer ampa_live_VOTRE_CLE"

curl https://ampamail.com/api/v1/audience/groups -H "Authorization: Bearer ampa_live_VOTRE_CLE"

{
  "groups": [
    {"id": "1ba88f96-…", "name": "Administration", "description": null, "contacts": 12},
    {"id": "7c2d01e5-…", "name": "Parents d’élèves", "description": "Rentrée 2026", "contacts": 431}
  ]
}

HTTP/1.1 400 Bad Request
{
  "detail": "L'adresse d'expédition doit utiliser un domaine vérifié de votre organisation (gmail.com ne l'est pas)."
}

<?php
// ampa.php — petit client réutilisable
function ampa(string $method, string $path, array $body = null, array $headers = []): array
{
    $ch = curl_init('https://ampamail.com/api/v1' . $path);
    $headers[] = 'Authorization: Bearer ' . getenv('AMPA_API_KEY');
    $headers[] = 'Content-Type: application/json';
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_HTTPHEADER => $headers,
    ]);
    if ($body !== null) curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    $data = json_decode(curl_exec($ch), true);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($code >= 400) throw new RuntimeException("AMPA $code : " . json_encode($data['detail'] ?? $data));
    return $data;
}

// 1. À l’inscription d’un parent : contact + groupe, puis email de bienvenue
ampa('PUT', '/audience/contacts', [
    'email' => $parent->email,
    'first_name' => $parent->prenom,
    'custom_fields' => ['eleve' => $eleve->prenom, 'classe' => $eleve->classe],
    'groups' => ['Parents d’élèves'],
]);
ampa('POST', '/emails/send', [
    'from' => 'noreply@votre-ecole.dz',
    'from_name' => 'Votre École',
    'to' => [$parent->email],
    'template_id' => getenv('AMPA_TEMPLATE_BIENVENUE'),
    'variables' => ['prenom' => $parent->prenom, 'eleve' => $eleve->prenom],
], ['Idempotency-Key: bienvenue-' . $parent->id]);

// 2. Mot de passe oublié : code à usage unique
ampa('POST', '/emails/send', [
    'from' => 'securite@votre-ecole.dz',
    'to' => [$user->email],
    'subject' => 'Votre code : {{ code }}',
    'text' => "Votre code de réinitialisation est {{ code }}. Il expire dans 10 minutes.",
    'variables' => ['code' => $code],
], ['Idempotency-Key: reset-' . $demande->id]);