Documentation API

Presentation

Skyden est un service d'envoi d'OTP et de messages via WhatsApp. Il fournit une API REST simple a integrer, des SDK JavaScript et PHP, et un dashboard pour gerer votre compte.

Base URL : https://wa-manager.fetties-event.com/api

Demarrage rapide

3 etapes pour envoyer votre premier OTP :

1. Creez un compte et obtenez votre cle API.

2. Installez le SDK dans votre projet.

3. Appelez sendOTP().

// JavaScript
const skyden = new Skyden('votre-cle-api');
await skyden.sendOTP('+243000000000', '123456');

Authentification

Toutes les requetes API necessitent une cle API dans le header HTTP :

X-API-Key: votre-cle-api

Vous trouvez votre cle API dans votre dashboard client.

Envoyer un OTP

POST /api/send-otp.php

Envoie un code OTP formate via WhatsApp.

Parametres

Exemple

// cURL
curl -X POST https://wa-manager.fetties-event.com/api/send-otp.php \
  -H "Content-Type: application/json" \
  -H "X-API-Key: votre-cle-api" \
  -d '{"phone":"+243000000000","otp":"123456"}'

Reponse (succes)

{
  "success": true,
  "message": "OTP envoye.",
  "data": {
    "phone": "+243000000000",
    "remaining": 497,
    "used": 3,
    "total": 500
  }
}

Envoyer un message

POST /api/send-message.php

Envoie un message personnalise via WhatsApp.

Parametres

Verifier le quota

GET /api/quota.php

Retourne le nombre de messages restants dans votre abonnement.

curl https://wa-manager.fetties-event.com/api/quota.php \
  -H "X-API-Key: votre-cle-api"

SDK JavaScript

Ajoutez cette ligne dans votre HTML :

<script src="https://wa-manager.fetties-event.com/sdk/skyden.js"></script>

Utilisation :

const skyden = new Skyden('votre-cle-api');

await skyden.sendOTP('+243000000000', '123456');
await skyden.sendMessage('+243000000000', 'Bonjour');
const quota = await skyden.getQuota();

SDK PHP

Telechargez le SDK et incluez-le :

require_once 'Skyden.php';
$skyden = new Skyden('votre-cle-api');
$skyden->sendOTP('+243000000000', '123456');

Codes d'erreur

Rate Limiting

L'API est limitee a 60 requetes par minute par cle API. Les headers suivants sont renvoyes :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 42

Erreur SSL sur WAMP/XAMPP (Windows)

Si vous rencontrez l'erreur unable to get local issuer certificate :

Solution 1 : Le SDK Skyden desactive deja la verification SSL par defaut.

Solution 2 : Telechargez le certificat CA :

# 1. Telecharger le certificat
https://curl.haxx.se/ca/cacert.pem

# 2. Placer dans C:/wamp/bin/php/

# 3. Ajouter dans php.ini :
curl.cainfo = "C:/wamp/bin/php/cacert.pem"