Documentation Index
Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
Use this file to discover all available pages before exploring further.
Vue d’ensemble
Suivez le statut d’une recharge internet et récupérez les détails de la carte lorsqu’elle est livrée.
Paramètres de chemin
ID interne de la recharge provenant de la réponse /internet/send
Champs de réponse
- HANDLING : En cours de traitement (3 à 45s) - FULFILLED : Terminé avec le code carte ✅
- REFUNDED : Échoué et remboursé ❌ - QUEUED : Programmé (12 à 48h) ⏰
Code de carte activé (disponible lorsque FULFILLED)
Numéro de transaction Algérie Télécom
Exemples
curl https://api.oneclickdz.com/v3/internet/check-id/6901616fe9e88196b4eb64b2 \
-H "X-Access-Token: YOUR_API_KEY"
Réponse lorsque livré
{
"success": true,
"data": {
"_id": "6901616fe9e88196b4eb64b2",
"ref": "internet-order-001",
"status": "FULFILLED",
"type": "ADSL",
"number": "036362608",
"topup_amount": 1000,
"card_code": "123456789012",
"num_trans": "AT-2025-12345",
"date_traitement": "2025-10-29T01:05:30.000Z",
"created_at": "2025-10-29T01:00:00.000Z"
}
}
Exemple d’interrogation
async function pollInternetStatus(topupId) {
const maxAttempts = 60;
for (let i = 0; i < maxAttempts; i++) {
const response = await fetch(
`https://api.oneclickdz.com/v3/internet/check-id/${topupId}`,
{ headers: { "X-Access-Token": process.env.API_KEY } }
);
const { data } = await response.json();
if (["FULFILLED", "REFUNDED", "QUEUED"].includes(data.status)) {
return data;
}
await new Promise((resolve) => setTimeout(resolve, 5000));
}
throw new Error("Timeout");
}
Gestion du statut QUEUED
QUEUED signifie que la recharge est programmée pour plus tard (12 à 48 heures). Ne la traitez pas comme un échec.
if (status === "QUEUED") {
// Save for later verification
await db.orders.update({
id: orderId,
status: "SCHEDULED",
message: "Card will be delivered within 48 hours",
});
// Check again after 24h
scheduleRecheck(orderId, 24 * 60 * 60 * 1000);
}
Liens utiles
Vérifier par Référence
Suivre avec une référence personnalisée
Envoyer une Recharge
Créer une nouvelle commande
