API & SDK

Cle API de production

ag_live_****************************7f3a

POST
/api/v1/links

Creer un lien dynamique

Body

{
  "alias": "nouveau-lien",
  "destination": "https://example.com",
  "campaign": "Soldes Ete 2025"
}

Response

{
  "id": "link_123...",
  "shortUrl": "https://atlasgate.byfrontline.com/nouveau-lien",
  "qrCode": "https://api.atlasgate.ma/qr/link_123..."
}
GET
/api/v1/links/:id

Recuperer les details d'un lien

Response

{
  "id": "link_123...",
  "alias": "nouveau-lien",
  "clicks": 1450,
  "status": "active"
}
GET
/api/v1/campaigns

Lister les campagnes

Response

{
  "data": [
    {
      "id": "camp_1",
      "name": "Soldes Ete 2025",
      "clicks": 12500,
      "conversions": 450
    }
  ],
  "meta": { "total": 12, "page": 1 }
}
GET
/api/v1/analytics/:linkId

Analytics temps reel

Response

{
  "period": "7d",
  "clicks": 1250,
  "devices": { "mobile": 80, "desktop": 20 },
  "locations": { "MA": 95, "FR": 5 }
}
Authentification

Toutes les requetes API doivent inclure votre cle API dans le header Authorization :

Authorization: Bearer ag_live_m3k9x2n7q4r8v1b5t6w0y9p3a2d8f7j
Codes d'erreur
401 UnauthorizedCle API invalide ou manquante
429 Too Many RequestsLimite atteinte (1000/min)