Pedidos

Reabastecer

Um pedido concluído pode ter reposição quando o serviço aceita. Cada pedido pode ter reposição uma vez a cada 6 horas, sem data final. refill_status mostra o resultado e, se foi recusada, o motivo.

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

Chave de API obrigatória
Limite de requisições atingido
Corpo:application/x-www-form-urlencoded

A cada 6 horas

Uma solicitação de reposição por pedido a cada 6 horas, contadas a partir da solicitação anterior, seja qual for o resultado. Se pedir cedo demais, você recebe REFILL_COOLDOWN com o momento em que pode pedir.

Parâmetros

Sempre enviado

keystringObrigatório: Sua chave de API.
actionstringObrigatório: refillDeve ser a string literal "refill".

Envie `order` ou `orders`.

orderintegerUm destes: Um número de pedido. A resposta é um objeto com o novo ID de reposição em refill.
ordersstring (CSV)Um destes: Até 100 números de pedido separados por vírgula. A resposta é um array; 30 IDs de pedido por minuto.

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));

Substitua YOUR_API_KEY pela chave da sua página de API.

Resposta200 OK

{
  "refill": 5501
}

Erros

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
Esse pedido não existe na sua conta.
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"}}
Uma reposição foi solicitada há menos de 6 horas. details.time informa quando você pode pedir de novo.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
O pedido ainda está em andamento. A reposição é possível depois que ele for concluído.

Todos os códigos de status

Quando uma reposição é possível

O pedido deve estar concluído ou parcial, o serviço deve aceitar reposição (o indicador refill dele é true) e devem ter se passado pelo menos 6 horas desde a última solicitação de reposição. Não há limite de tempo depois do pedido. A resposta de order é o ID da reposição; can_refill e refill_available_at em status informam isso com antecedência.

Listar serviços

Vários pedidos

Com orders a resposta é um array com uma entrada por pedido, cada uma com o ID da reposição ou um objeto de erro. Um problema com um pedido nunca interrompe os outros. Até 100 IDs.

Requisição

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

Resposta200 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 retorna o estado de uma reposição ou de até 100. Uma reposição que ninguém responde por 7 dias deixa de ser acompanhada e aparece como Pending, para não bloquear uma nova solicitação.

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

Envie `refill` ou `refills`

refillintegerUm destes: Um ID de reposição.
refillsstring (CSV)Um destes: Até 100 IDs de reposição separados por vírgula.

Campos da resposta

statusstring: A palavra de status. Veja Valores de status abaixo.
status_keystring: Forma estável em minúsculas do status.
orderinteger: O pedido ao qual a reposição pertence.
reason_codestring | null: Por que uma reposição foi recusada, ou null.
reasonstring | null: Uma frase fixa em inglês para reason_code, ou null.
created_atstring: Quando a reposição foi solicitada.
updated_atstring: Quando mudou pela última vez.

Requisição

key=YOUR_API_KEY&action=refill_status&refill=5501

Resposta200 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"
}

Requisição

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

Resposta200 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
  }
]

Valores de status

Pendingstatus_key=pending
Pending — solicitada, ou o resultado ainda não é conhecido.
In progressstatus_key=in_progress
In progress — a reposição está sendo feita.
Completedstatus_key=completed
Completed — a reposição foi feita.
Rejectedstatus_key=rejected
Rejected — a reposição foi recusada. reason_code diz por quê.

Motivos de recusa

Uma recusa sempre traz um destes códigos. Trate um código desconhecido como uma recusa genérica: novos códigos podem ser adicionados.

Códigos de motivo e frases

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.

Quando uma reposição é pedida mas ninguém responde, ela permanece Pending e nunca é enviada duas vezes por acidente.

Erros de reposição

404
ORDER_NOT_FOUND
Order not found
Nenhum pedido com este número pertence à sua conta. Corrija a requisição primeiro.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
Não é possível repor este pedido. Corrija a requisição primeiro.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
A reposição é possível depois que o pedido for concluído. Tentar de novo pode ajudar.
409
REFILL_COOLDOWN
You can request a refill again after {time}
Uma reposição foi solicitada para este pedido recentemente. Tente de novo depois de details.time. Tentar de novo pode ajudar.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
Já existe uma reposição em andamento para este pedido. Tentar de novo pode ajudar.
404
REFILL_NOT_FOUND
Refill not found
Nenhuma reposição com este ID pertence à sua conta. Corrija a requisição primeiro.

Pedidos

Reabastecer

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

Chave de API obrigatória
Limite de requisições atingido
Corpo:application/x-www-form-urlencoded

A cada 6 horas

Parâmetros

Sempre enviado

keystringObrigatório: Sua chave de API.
actionstringObrigatório: refillDeve ser a string literal "refill".

Envie `order` ou `orders`.

orderintegerUm destes: Um número de pedido. A resposta é um objeto com o novo ID de reposição em refill.
ordersstring (CSV)Um destes: Até 100 números de pedido separados por vírgula. A resposta é um array; 30 IDs de pedido por minuto.

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));

Substitua YOUR_API_KEY pela chave da sua página de API.

Resposta200 OK

{
  "refill": 5501
}

Erros

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
Esse pedido não existe na sua conta.
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"}}
Uma reposição foi solicitada há menos de 6 horas. details.time informa quando você pode pedir de novo.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
O pedido ainda está em andamento. A reposição é possível depois que ele for concluído.

Todos os códigos de status

Quando uma reposição é possível

Listar serviços

Vários pedidos

Com orders a resposta é um array com uma entrada por pedido, cada uma com o ID da reposição ou um objeto de erro. Um problema com um pedido nunca interrompe os outros. Até 100 IDs.

Requisição

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

Resposta200 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

Envie `refill` ou `refills`

refillintegerUm destes: Um ID de reposição.
refillsstring (CSV)Um destes: Até 100 IDs de reposição separados por vírgula.

Campos da resposta

statusstring: A palavra de status. Veja Valores de status abaixo.
status_keystring: Forma estável em minúsculas do status.
orderinteger: O pedido ao qual a reposição pertence.
reason_codestring | null: Por que uma reposição foi recusada, ou null.
reasonstring | null: Uma frase fixa em inglês para reason_code, ou null.
created_atstring: Quando a reposição foi solicitada.
updated_atstring: Quando mudou pela última vez.

Requisição

key=YOUR_API_KEY&action=refill_status&refill=5501

Resposta200 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"
}

Requisição

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

Resposta200 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
  }
]

Valores de status

Pendingstatus_key=pending
Pending — solicitada, ou o resultado ainda não é conhecido.
In progressstatus_key=in_progress
In progress — a reposição está sendo feita.
Completedstatus_key=completed
Completed — a reposição foi feita.
Rejectedstatus_key=rejected
Rejected — a reposição foi recusada. reason_code diz por quê.

Motivos de recusa

Uma recusa sempre traz um destes códigos. Trate um código desconhecido como uma recusa genérica: novos códigos podem ser adicionados.

Códigos de motivo e frases

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.

Quando uma reposição é pedida mas ninguém responde, ela permanece Pending e nunca é enviada duas vezes por acidente.

Erros de reposição

404
ORDER_NOT_FOUND
Order not found
Nenhum pedido com este número pertence à sua conta. Corrija a requisição primeiro.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
Não é possível repor este pedido. Corrija a requisição primeiro.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
A reposição é possível depois que o pedido for concluído. Tentar de novo pode ajudar.
409
REFILL_COOLDOWN
You can request a refill again after {time}
Uma reposição foi solicitada para este pedido recentemente. Tente de novo depois de details.time. Tentar de novo pode ajudar.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
Já existe uma reposição em andamento para este pedido. Tentar de novo pode ajudar.
404
REFILL_NOT_FOUND
Refill not found
Nenhuma reposição com este ID pertence à sua conta. Corrija a requisição primeiro.

Reabastecer

Parâmetros

Sempre enviado

Envie order ou orders.

Erros

Quando uma reposição é possível

Vários pedidos

refill_status

Envie refill ou refills

Campos da resposta

Valores de status

Motivos de recusa

Códigos de motivo e frases

Erros de reposição

Reabastecer

Parâmetros

Sempre enviado

Envie order ou orders.

Erros

Quando uma reposição é possível

Vários pedidos

refill_status

Envie refill ou refills

Campos da resposta

Valores de status

Motivos de recusa

Códigos de motivo e frases

Erros de reposição

Envie `order` ou `orders`.

Envie `refill` ou `refills`

Envie `order` ou `orders`.

Envie `refill` ou `refills`