Commandes

Recomplément

Une commande terminée peut être rechargée lorsque le service le permet. Chaque commande peut être rechargée une fois toutes les 6 heures, sans date limite. refill_status affiche le résultat et, en cas de refus, le motif.

POSThttps://notpanel.com/api/v3action=refill

Clé d'API requise
Limite de requêtes atteinte
Corps :application/x-www-form-urlencoded

Toutes les 6 heures

Une demande de recharge par commande toutes les 6 heures, comptées à partir de la demande précédente quel que soit son résultat. Si vous redemandez trop tôt, vous obtenez REFILL_COOLDOWN avec le moment où vous pourrez demander.

Paramètres

Toujours envoyé

keystringRequis: Votre clé API.
actionstringRequis: refillDoit être la chaîne littérale « refill ».

Envoyez `order` ou `orders`.

orderintegerL'un de ceux-ci: Un numéro de commande. La réponse est un objet avec le nouvel ID de recharge dans refill.
ordersstring (CSV)L'un de ceux-ci: Jusqu'à 100 numéros de commande séparés par des virgules. La réponse est un tableau ; 30 ID de commande par minute.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=refill&order=1234567"

const res = await fetch("https://notpanel.com/api/v3", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "refill",
    order: "1234567",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": "1234567",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refill',
    'order' => '1234567',
]);

$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $body,
        'ignore_errors' => true,
    ],
]));

print_r(json_decode($response, true));

Remplacez YOUR_API_KEY par la clé de votre page API.

Réponse200 OK

{
  "refill": 5501
}

Erreurs

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
Cette commande n'existe pas sur votre compte.
409
{"error":"You can request a refill again after 2026-10-03T18:35:00.000Z","error_code":"REFILL_COOLDOWN","retryable":true,"details":{"time":"2026-10-03T18:35:00.000Z"}}
Une recharge a été demandée il y a moins de 6 heures. details.time indique quand vous pouvez redemander.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
La commande est encore en cours. La recharge est possible une fois la commande terminée.

Tous les codes de statut

Quand une recharge est possible

La commande doit être terminée ou partielle, le service doit prendre en charge la recharge (son indicateur refill vaut true), et au moins 6 heures doivent s'être écoulées depuis la dernière demande de recharge. Il n'y a pas de limite de durée après la commande. La réponse de order est l'ID de recharge ; can_refill et refill_available_at dans status vous l'indiquent à l'avance.

Lister les services

Plusieurs commandes

Avec orders, la réponse est un tableau avec une entrée par commande, chacune avec l'ID de recharge ou un objet d'erreur. Un problème sur une commande n'arrête jamais les autres. Jusqu'à 100 ID.

Requête

key=YOUR_API_KEY&action=refill&orders=1234567,1234568,1234577

Réponse200 OK

[
  {
    "order": 1234567,
    "refill": 5501
  },
  {
    "order": 1234568,
    "refill": {
      "error": "You can request a refill again after 2026-10-03T18:35:00.000Z",
      "error_code": "REFILL_COOLDOWN",
      "retryable": true,
      "details": {
        "time": "2026-10-03T18:35:00.000Z"
      }
    }
  },
  {
    "order": 1234577,
    "refill": {
      "error": "Refill is available after the order is completed",
      "error_code": "REFILL_NOT_COMPLETED",
      "retryable": true
    }
  }
]

refill_status

action=refill_status renvoie l'état d'une recharge ou de jusqu'à 100. Une recharge à laquelle personne ne répond pendant 7 jours cesse d'être suivie et apparaît comme Pending, afin de ne pas bloquer une nouvelle demande.

POSThttps://notpanel.com/api/v3action=refill_status

Envoyez `refill` ou `refills`

refillintegerL'un de ceux-ci: Un ID de recharge.
refillsstring (CSV)L'un de ceux-ci: Jusqu'à 100 ID de recharge séparés par des virgules.

Champs de la réponse

statusstring: Le mot de statut. Voir Valeurs de statut ci-dessous.
status_keystring: Forme stable en minuscules du statut.
orderinteger: La commande à laquelle la recharge appartient.
reason_codestring | null: Pourquoi une recharge a été refusée, ou null.
reasonstring | null: Une phrase anglaise fixe pour reason_code, ou null.
created_atstring: Quand la recharge a été demandée.
updated_atstring: Quand elle a changé pour la dernière fois.

Requête

key=YOUR_API_KEY&action=refill_status&refill=5501

Réponse200 OK

{
  "status": "Completed",
  "status_key": "completed",
  "order": 1234567,
  "reason_code": null,
  "reason": null,
  "created_at": "2026-10-03T12:35:00Z",
  "updated_at": "2026-10-03T13:05:00Z"
}

Requête

key=YOUR_API_KEY&action=refill_status&refills=5501,5502,9

Réponse200 OK

[
  {
    "refill": 5501,
    "status": "Completed",
    "status_key": "completed",
    "order": 1234567,
    "reason_code": null,
    "reason": null,
    "created_at": "2026-10-03T12:35:00Z",
    "updated_at": "2026-10-03T13:05:00Z"
  },
  {
    "refill": 5502,
    "status": "Rejected",
    "status_key": "rejected",
    "order": 1234568,
    "reason_code": "refill_too_early",
    "reason": "This order cannot be refilled yet. Try again later.",
    "created_at": "2026-10-03T12:40:00Z",
    "updated_at": "2026-10-03T12:41:00Z"
  },
  {
    "refill": 9,
    "error": "Refill not found",
    "error_code": "REFILL_NOT_FOUND",
    "retryable": false
  }
]

Valeurs de statut

Pendingstatus_key=pending
Pending — demandée, ou le résultat n'est pas encore connu.
In progressstatus_key=in_progress
In progress — la recharge est en cours.
Completedstatus_key=completed
Completed — la recharge a été effectuée.
Rejectedstatus_key=rejected
Rejected — la recharge a été refusée. reason_code indique pourquoi.

Motifs de refus

Un refus porte toujours l'un de ces codes. Traitez un code inconnu comme un refus générique : de nouveaux codes peuvent être ajoutés.

Codes de motif et phrases

refill_too_early: This order cannot be refilled yet. Try again later.
refill_daily_limit: Refills for today are used up. Try again tomorrow.
refill_not_completed: Refill is possible after the order is completed.
refill_not_eligible: This order cannot be refilled.
refill_refused: The refill was not accepted. Try again later.

Lorsqu'une recharge est demandée mais que personne ne répond, elle reste Pending et n'est jamais envoyée deux fois par accident.

Erreurs de recharge

404
ORDER_NOT_FOUND
Order not found
Aucune commande portant ce numéro n'appartient à votre compte. Corrigez d'abord la requête.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
La recharge n'est pas possible pour cette commande. Corrigez d'abord la requête.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
La recharge est possible une fois la commande terminée. Réessayer peut aider.
409
REFILL_COOLDOWN
You can request a refill again after {time}
Une recharge a été demandée récemment pour cette commande. Réessayez après details.time. Réessayer peut aider.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
Une recharge est déjà en cours pour cette commande. Réessayer peut aider.
404
REFILL_NOT_FOUND
Refill not found
Aucune recharge portant cet ID n'appartient à votre compte. Corrigez d'abord la requête.

Commandes

Recomplément

POSThttps://notpanel.com/api/v3action=refill

Clé d'API requise
Limite de requêtes atteinte
Corps :application/x-www-form-urlencoded

Toutes les 6 heures

Paramètres

Toujours envoyé

keystringRequis: Votre clé API.
actionstringRequis: refillDoit être la chaîne littérale « refill ».

Envoyez `order` ou `orders`.

orderintegerL'un de ceux-ci: Un numéro de commande. La réponse est un objet avec le nouvel ID de recharge dans refill.
ordersstring (CSV)L'un de ceux-ci: Jusqu'à 100 numéros de commande séparés par des virgules. La réponse est un tableau ; 30 ID de commande par minute.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=refill&order=1234567"

const res = await fetch("https://notpanel.com/api/v3", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "refill",
    order: "1234567",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": "1234567",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refill',
    'order' => '1234567',
]);

$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $body,
        'ignore_errors' => true,
    ],
]));

print_r(json_decode($response, true));

Remplacez YOUR_API_KEY par la clé de votre page API.

Réponse200 OK

{
  "refill": 5501
}

Erreurs

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
Cette commande n'existe pas sur votre compte.
409
{"error":"You can request a refill again after 2026-10-03T18:35:00.000Z","error_code":"REFILL_COOLDOWN","retryable":true,"details":{"time":"2026-10-03T18:35:00.000Z"}}
Une recharge a été demandée il y a moins de 6 heures. details.time indique quand vous pouvez redemander.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
La commande est encore en cours. La recharge est possible une fois la commande terminée.

Tous les codes de statut

Quand une recharge est possible

Lister les services

Plusieurs commandes

Requête

key=YOUR_API_KEY&action=refill&orders=1234567,1234568,1234577

Réponse200 OK

[
  {
    "order": 1234567,
    "refill": 5501
  },
  {
    "order": 1234568,
    "refill": {
      "error": "You can request a refill again after 2026-10-03T18:35:00.000Z",
      "error_code": "REFILL_COOLDOWN",
      "retryable": true,
      "details": {
        "time": "2026-10-03T18:35:00.000Z"
      }
    }
  },
  {
    "order": 1234577,
    "refill": {
      "error": "Refill is available after the order is completed",
      "error_code": "REFILL_NOT_COMPLETED",
      "retryable": true
    }
  }
]

refill_status

POSThttps://notpanel.com/api/v3action=refill_status

Envoyez `refill` ou `refills`

refillintegerL'un de ceux-ci: Un ID de recharge.
refillsstring (CSV)L'un de ceux-ci: Jusqu'à 100 ID de recharge séparés par des virgules.

Champs de la réponse

statusstring: Le mot de statut. Voir Valeurs de statut ci-dessous.
status_keystring: Forme stable en minuscules du statut.
orderinteger: La commande à laquelle la recharge appartient.
reason_codestring | null: Pourquoi une recharge a été refusée, ou null.
reasonstring | null: Une phrase anglaise fixe pour reason_code, ou null.
created_atstring: Quand la recharge a été demandée.
updated_atstring: Quand elle a changé pour la dernière fois.

Requête

key=YOUR_API_KEY&action=refill_status&refill=5501

Réponse200 OK

{
  "status": "Completed",
  "status_key": "completed",
  "order": 1234567,
  "reason_code": null,
  "reason": null,
  "created_at": "2026-10-03T12:35:00Z",
  "updated_at": "2026-10-03T13:05:00Z"
}

Requête

key=YOUR_API_KEY&action=refill_status&refills=5501,5502,9

Réponse200 OK

[
  {
    "refill": 5501,
    "status": "Completed",
    "status_key": "completed",
    "order": 1234567,
    "reason_code": null,
    "reason": null,
    "created_at": "2026-10-03T12:35:00Z",
    "updated_at": "2026-10-03T13:05:00Z"
  },
  {
    "refill": 5502,
    "status": "Rejected",
    "status_key": "rejected",
    "order": 1234568,
    "reason_code": "refill_too_early",
    "reason": "This order cannot be refilled yet. Try again later.",
    "created_at": "2026-10-03T12:40:00Z",
    "updated_at": "2026-10-03T12:41:00Z"
  },
  {
    "refill": 9,
    "error": "Refill not found",
    "error_code": "REFILL_NOT_FOUND",
    "retryable": false
  }
]

Valeurs de statut

Pendingstatus_key=pending
Pending — demandée, ou le résultat n'est pas encore connu.
In progressstatus_key=in_progress
In progress — la recharge est en cours.
Completedstatus_key=completed
Completed — la recharge a été effectuée.
Rejectedstatus_key=rejected
Rejected — la recharge a été refusée. reason_code indique pourquoi.

Motifs de refus

Un refus porte toujours l'un de ces codes. Traitez un code inconnu comme un refus générique : de nouveaux codes peuvent être ajoutés.

Codes de motif et phrases

refill_too_early: This order cannot be refilled yet. Try again later.
refill_daily_limit: Refills for today are used up. Try again tomorrow.
refill_not_completed: Refill is possible after the order is completed.
refill_not_eligible: This order cannot be refilled.
refill_refused: The refill was not accepted. Try again later.

Lorsqu'une recharge est demandée mais que personne ne répond, elle reste Pending et n'est jamais envoyée deux fois par accident.

Erreurs de recharge

404
ORDER_NOT_FOUND
Order not found
Aucune commande portant ce numéro n'appartient à votre compte. Corrigez d'abord la requête.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
La recharge n'est pas possible pour cette commande. Corrigez d'abord la requête.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
La recharge est possible une fois la commande terminée. Réessayer peut aider.
409
REFILL_COOLDOWN
You can request a refill again after {time}
Une recharge a été demandée récemment pour cette commande. Réessayez après details.time. Réessayer peut aider.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
Une recharge est déjà en cours pour cette commande. Réessayer peut aider.
404
REFILL_NOT_FOUND
Refill not found
Aucune recharge portant cet ID n'appartient à votre compte. Corrigez d'abord la requête.

Recomplément

Paramètres

Toujours envoyé

Envoyez order ou orders.

Erreurs

Quand une recharge est possible

Plusieurs commandes

refill_status

Envoyez refill ou refills

Champs de la réponse

Valeurs de statut

Motifs de refus

Codes de motif et phrases

Erreurs de recharge

Recomplément

Paramètres

Toujours envoyé

Envoyez order ou orders.

Erreurs

Quand une recharge est possible

Plusieurs commandes

refill_status

Envoyez refill ou refills

Champs de la réponse

Valeurs de statut

Motifs de refus

Codes de motif et phrases

Erreurs de recharge

Envoyez `order` ou `orders`.

Envoyez `refill` ou `refills`

Envoyez `order` ou `orders`.

Envoyez `refill` ou `refills`