Referência

Erros

Todo erro tem um código fixo, um status HTTP e um indicador que diz se tentar de novo pode ajudar. Ramifique por error_code e retryable, não pelo texto da mensagem.

O formato do erro

Uma requisição com falha retorna um objeto JSON com o status HTTP do erro. O texto de error é uma frase fixa em inglês preenchida com valores tipados; nunca contém texto de outros sistemas.

Resposta de erro400 Bad Request

{
  "error": "Minimum quantity is 100",
  "error_code": "MINIMUM_QUANTITY",
  "retryable": false,
  "details": {
    "n": 100
  }
}

Campos do erro

errorstring: Uma mensagem fixa em inglês para pessoas. Scripts antigos que só leem error continuam funcionando.
error_codestring: O código de erro da lista abaixo. Seguro para ramificar.
retryableboolean: true quando enviar a mesma requisição de novo mais tarde pode funcionar.
detailsobject: Os valores preenchidos na mensagem, por nome, como param, rule, n ou time. Presente só quando há algum.
retry_afterinteger: Segundos de espera antes de tentar de novo. Presente quando a espera é conhecida, e espelhado no cabeçalho Retry-After.

Ações que recebem vários IDs colocam o mesmo objeto de erro dentro do resultado em vez de fazer a requisição inteira falhar, e o status HTTP continua 200. Isso vale para cancel, refill, refill_status e para status com orders.

Status HTTP

Estes são os status que a API usa. As frases de motivo HTTP são nomes de protocolo e ficam em inglês.

400
Bad Request
A requisição não é válida. Corrija-a antes de enviar de novo.
401
Unauthorized
A chave de API não é válida.
402
Payment Required
O saldo da carteira está baixo demais.
403
403
A conta não pode usar a API neste momento.
404
Not Found
O serviço, pedido, reposição ou webhook não foi encontrado.
405
405
Somente POST é aceito.
409
Conflict
A requisição conflita com o estado de um serviço, de um pedido ou de um ID de requisição anterior.
410
410
O serviço foi descontinuado.
413
413
O corpo da requisição é grande demais.
429
Too Many Requests
Um limite de taxa foi atingido. Aguarde e tente de novo.
500
500
Uma falha do nosso lado. Repetir a requisição é seguro.
503
503
A API ou os pedidos estão pausados por um curto período. Aguarde conforme Retry-After.

Como tentar de novo com segurança

Quando retryable é true, aguarde retry_after ou o cabeçalho Retry-After, some uma variação aleatória e envie a requisição de novo. Quando é false, mude a requisição primeiro. Se uma chamada a add expirar ou falhar com INTERNAL_ERROR, envie-a de novo com o mesmo request_id (até 128 caracteres): você recebe o pedido original de volta, nunca um segundo.

Como o request_id funciona

Exemplos

Requisição

key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10

Resposta400 Bad Request

{
  "error": "Minimum quantity is 100",
  "error_code": "MINIMUM_QUANTITY",
  "retryable": false,
  "details": {
    "n": 100
  }
}

Requisição

key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10000

Resposta402 Payment Required

{
  "error": "Insufficient balance",
  "error_code": "INSUFFICIENT_BALANCE",
  "retryable": false
}

Requisição

key=YOUR_API_KEY&action=balance

Resposta429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "error_code": "API_RATE_LIMITED",
  "retryable": true,
  "retry_after": 12
}

Requisição

key=YOUR_API_KEY&action=add&link=https://instagram.com/example&quantity=100

Resposta400 Bad Request

{
  "error": "Missing required parameter: service",
  "error_code": "MISSING_PARAMETER",
  "retryable": false,
  "details": {
    "param": "service"
  }
}

Todos os códigos de erro

A mensagem é o modelo fixo; seus marcadores são preenchidos a partir de details. Cada código mostra seu status HTTP e se tentar de novo pode ajudar.

Requisição e conta

401
INVALID_KEY
Invalid API key
A chave está ausente, errada ou revogada. Corrija a requisição primeiro.
405
METHOD_NOT_ALLOWED
Use POST
A requisição não era um POST. Corrija a requisição primeiro.
413
BODY_TOO_LARGE
Request body too large
O corpo da requisição é grande demais. Corrija a requisição primeiro.
400
INVALID_ACTION
Invalid action
A ação não é uma das ações documentadas. Corrija a requisição primeiro.
400
MISSING_PARAMETER
Missing required parameter: {param}
Falta um parâmetro obrigatório. details.param o indica. Corrija a requisição primeiro.
400
INVALID_PARAMETER
Invalid {param}: {rule}
Um parâmetro tem um valor inválido. details.param e details.rule dizem qual e por quê. Corrija a requisição primeiro.
400
TOO_MANY_IDS
Maximum 100 IDs per request
Uma lista contém mais IDs do que uma requisição pode levar. Corrija a requisição primeiro.
403
INACTIVE_ACCOUNT
Account suspended
A conta está suspensa. Corrija a requisição primeiro.
403
EMAIL_UNVERIFIED
Email verification required
O e-mail da conta ainda não foi verificado. Corrija a requisição primeiro.

Disponibilidade e limites

503
API_DISABLED
The API is temporarily disabled
A API está desligada por um curto período. Retry-After diz quando tentar de novo. Tentar de novo pode ajudar.
429
API_RATE_LIMITED
Rate limit exceeded
Um limite de taxa foi atingido. Veja Limites de taxa. Tentar de novo pode ajudar.
500
INTERNAL_ERROR
Internal server error
Algo falhou do nosso lado. Repetir um add com o mesmo request_id é seguro. Tentar de novo pode ajudar.

Serviços e criação de pedidos

404
SERVICE_NOT_FOUND
Service not found
Nenhum serviço tem este ID, ou ele não está disponível para você. Corrija a requisição primeiro.
410
SERVICE_DISCONTINUED
Service has been discontinued
O serviço foi descontinuado. Corrija a requisição primeiro.
409
SERVICE_PAUSED
Service is temporarily unavailable
O serviço está pausado por enquanto. Tente de novo mais tarde. Tentar de novo pode ajudar.
503
ORDER_PLACEMENT_PAUSED
Ordering is temporarily paused
Os pedidos estão pausados para todos por um curto período. Retry-After diz quando tentar de novo. Tentar de novo pode ajudar.
400
INVALID_LINK
Link is invalid for this service
O link não combina com este serviço. Corrija a requisição primeiro.
400
LINK_BLOCKED
This link is blocked. Contact support if this is a mistake.
O link está bloqueado. Fale com o suporte se achar que é um engano. Corrija a requisição primeiro.
409
LINK_BUSY
An order for this link is still running. Wait until it finishes.
Um pedido anterior para este link ainda está em andamento. Aguarde ele terminar. Tentar de novo pode ajudar.
400
MINIMUM_QUANTITY
Minimum quantity is {n}
A quantidade está abaixo do mínimo do serviço. Corrija a requisição primeiro.
400
MAXIMUM_QUANTITY
Maximum quantity is {n}
A quantidade está acima do máximo do serviço. Corrija a requisição primeiro.
400
QUANTITY_STEP
Quantity must be a multiple of {step}
A quantidade não é múltipla do passo do serviço. Corrija a requisição primeiro.
400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})
A quantidade não corresponde ao número de itens de uma lista ou de um campo de reações. Corrija a requisição primeiro.
400
MINIMUM_ORDER_AMOUNT
Minimum order amount is ${amount}
O pedido vale menos que o valor mínimo de pedido. Corrija a requisição primeiro.
402
INSUFFICIENT_BALANCE
Insufficient balance
O saldo da carteira é menor que a cobrança. Corrija a requisição primeiro.
400
INVALID_OPTION
Invalid {param}: {rule}
Um campo extra tem um valor inválido. details.param e details.rule dizem qual e por quê. Corrija a requisição primeiro.
400
OPTION_NOT_SUPPORTED
This service does not accept {param}
O serviço não aceita um campo que você enviou. Corrija a requisição primeiro.
400
DRIP_FEED_NOT_AVAILABLE
Drip-feed is not available for this service
O serviço não tem drip feed, ou não tem para esta quantidade. Corrija a requisição primeiro.
400
DRIP_FEED_CONFLICT
Send runs and interval, or drip_feed_total_minutes, not both
As duas formas de drip feed foram enviadas em uma mesma requisição. Corrija a requisição primeiro.
400
DRIP_FEED_INVALID
{rule}
Os valores de drip feed não cabem nos limites. A mensagem diz qual limite. Corrija a requisição primeiro.
429
ORDER_LIMIT_REACHED
Too many orders. Try again later.
Pedidos demais foram feitos ou estão abertos ao mesmo tempo. Tente de novo mais tarde. Tentar de novo pode ajudar.
409
SERVICE_CHANGED
Service settings changed while placing the order. Retry.
As configurações do serviço mudaram enquanto o pedido era feito. Envie a requisição de novo. Tentar de novo pode ajudar.
409
REQUEST_ID_CONFLICT
request_id was already used with different parameters
Este request_id já criou um pedido com parâmetros diferentes. Corrija a requisição primeiro.

Pedidos e cancelamento

404
ORDER_NOT_FOUND
Order not found
Nenhum pedido com este número pertence à sua conta. Corrija a requisição primeiro.
409
ORDER_FINISHED
Order is already {status}
O pedido já terminou. Corrija a requisição primeiro.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Não é possível cancelar este pedido. Corrija a requisição primeiro.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
A solicitação de cancelamento foi recusada. Você pode pedir de novo depois do tempo em details.time. Tentar de novo pode ajudar.

Reposições

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.

Webhooks

409
WEBHOOK_LIMIT
Maximum {limit} webhook endpoints per account
A conta já tem o número máximo de endpoints de webhook. Corrija a requisição primeiro.
404
WEBHOOK_NOT_FOUND
Webhook not found
Não existe na sua conta nenhum endpoint de webhook com este ID. Corrija a requisição primeiro.
400
INVALID_WEBHOOK_URL
Invalid webhook URL
A URL não é um endereço https público. Corrija a requisição primeiro.

O formato do erro

Uma requisição com falha retorna um objeto JSON com o status HTTP do erro. O texto de error é uma frase fixa em inglês preenchida com valores tipados; nunca contém texto de outros sistemas.

Resposta de erro400 Bad Request

{
  "error": "Minimum quantity is 100",
  "error_code": "MINIMUM_QUANTITY",
  "retryable": false,
  "details": {
    "n": 100
  }
}

Campos do erro

errorstring: Uma mensagem fixa em inglês para pessoas. Scripts antigos que só leem error continuam funcionando.
error_codestring: O código de erro da lista abaixo. Seguro para ramificar.
retryableboolean: true quando enviar a mesma requisição de novo mais tarde pode funcionar.
detailsobject: Os valores preenchidos na mensagem, por nome, como param, rule, n ou time. Presente só quando há algum.
retry_afterinteger: Segundos de espera antes de tentar de novo. Presente quando a espera é conhecida, e espelhado no cabeçalho Retry-After.

Status HTTP

Estes são os status que a API usa. As frases de motivo HTTP são nomes de protocolo e ficam em inglês.

400
Bad Request
A requisição não é válida. Corrija-a antes de enviar de novo.
401
Unauthorized
A chave de API não é válida.
402
Payment Required
O saldo da carteira está baixo demais.
403
403
A conta não pode usar a API neste momento.
404
Not Found
O serviço, pedido, reposição ou webhook não foi encontrado.
405
405
Somente POST é aceito.
409
Conflict
A requisição conflita com o estado de um serviço, de um pedido ou de um ID de requisição anterior.
410
410
O serviço foi descontinuado.
413
413
O corpo da requisição é grande demais.
429
Too Many Requests
Um limite de taxa foi atingido. Aguarde e tente de novo.
500
500
Uma falha do nosso lado. Repetir a requisição é seguro.
503
503
A API ou os pedidos estão pausados por um curto período. Aguarde conforme Retry-After.

Como tentar de novo com segurança

Como o request_id funciona

Exemplos

Requisição

key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10

Resposta400 Bad Request

{
  "error": "Minimum quantity is 100",
  "error_code": "MINIMUM_QUANTITY",
  "retryable": false,
  "details": {
    "n": 100
  }
}

Requisição

key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10000

Resposta402 Payment Required

{
  "error": "Insufficient balance",
  "error_code": "INSUFFICIENT_BALANCE",
  "retryable": false
}

Requisição

key=YOUR_API_KEY&action=balance

Resposta429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "error_code": "API_RATE_LIMITED",
  "retryable": true,
  "retry_after": 12
}

Requisição

key=YOUR_API_KEY&action=add&link=https://instagram.com/example&quantity=100

Resposta400 Bad Request

{
  "error": "Missing required parameter: service",
  "error_code": "MISSING_PARAMETER",
  "retryable": false,
  "details": {
    "param": "service"
  }
}

Todos os códigos de erro

A mensagem é o modelo fixo; seus marcadores são preenchidos a partir de details. Cada código mostra seu status HTTP e se tentar de novo pode ajudar.

Requisição e conta

401
INVALID_KEY
Invalid API key
A chave está ausente, errada ou revogada. Corrija a requisição primeiro.
405
METHOD_NOT_ALLOWED
Use POST
A requisição não era um POST. Corrija a requisição primeiro.
413
BODY_TOO_LARGE
Request body too large
O corpo da requisição é grande demais. Corrija a requisição primeiro.
400
INVALID_ACTION
Invalid action
A ação não é uma das ações documentadas. Corrija a requisição primeiro.
400
MISSING_PARAMETER
Missing required parameter: {param}
Falta um parâmetro obrigatório. details.param o indica. Corrija a requisição primeiro.
400
INVALID_PARAMETER
Invalid {param}: {rule}
Um parâmetro tem um valor inválido. details.param e details.rule dizem qual e por quê. Corrija a requisição primeiro.
400
TOO_MANY_IDS
Maximum 100 IDs per request
Uma lista contém mais IDs do que uma requisição pode levar. Corrija a requisição primeiro.
403
INACTIVE_ACCOUNT
Account suspended
A conta está suspensa. Corrija a requisição primeiro.
403
EMAIL_UNVERIFIED
Email verification required
O e-mail da conta ainda não foi verificado. Corrija a requisição primeiro.

Disponibilidade e limites

503
API_DISABLED
The API is temporarily disabled
A API está desligada por um curto período. Retry-After diz quando tentar de novo. Tentar de novo pode ajudar.
429
API_RATE_LIMITED
Rate limit exceeded
Um limite de taxa foi atingido. Veja Limites de taxa. Tentar de novo pode ajudar.
500
INTERNAL_ERROR
Internal server error
Algo falhou do nosso lado. Repetir um add com o mesmo request_id é seguro. Tentar de novo pode ajudar.

Serviços e criação de pedidos

404
SERVICE_NOT_FOUND
Service not found
Nenhum serviço tem este ID, ou ele não está disponível para você. Corrija a requisição primeiro.
410
SERVICE_DISCONTINUED
Service has been discontinued
O serviço foi descontinuado. Corrija a requisição primeiro.
409
SERVICE_PAUSED
Service is temporarily unavailable
O serviço está pausado por enquanto. Tente de novo mais tarde. Tentar de novo pode ajudar.
503
ORDER_PLACEMENT_PAUSED
Ordering is temporarily paused
Os pedidos estão pausados para todos por um curto período. Retry-After diz quando tentar de novo. Tentar de novo pode ajudar.
400
INVALID_LINK
Link is invalid for this service
O link não combina com este serviço. Corrija a requisição primeiro.
400
LINK_BLOCKED
This link is blocked. Contact support if this is a mistake.
O link está bloqueado. Fale com o suporte se achar que é um engano. Corrija a requisição primeiro.
409
LINK_BUSY
An order for this link is still running. Wait until it finishes.
Um pedido anterior para este link ainda está em andamento. Aguarde ele terminar. Tentar de novo pode ajudar.
400
MINIMUM_QUANTITY
Minimum quantity is {n}
A quantidade está abaixo do mínimo do serviço. Corrija a requisição primeiro.
400
MAXIMUM_QUANTITY
Maximum quantity is {n}
A quantidade está acima do máximo do serviço. Corrija a requisição primeiro.
400
QUANTITY_STEP
Quantity must be a multiple of {step}
A quantidade não é múltipla do passo do serviço. Corrija a requisição primeiro.
400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})
A quantidade não corresponde ao número de itens de uma lista ou de um campo de reações. Corrija a requisição primeiro.
400
MINIMUM_ORDER_AMOUNT
Minimum order amount is ${amount}
O pedido vale menos que o valor mínimo de pedido. Corrija a requisição primeiro.
402
INSUFFICIENT_BALANCE
Insufficient balance
O saldo da carteira é menor que a cobrança. Corrija a requisição primeiro.
400
INVALID_OPTION
Invalid {param}: {rule}
Um campo extra tem um valor inválido. details.param e details.rule dizem qual e por quê. Corrija a requisição primeiro.
400
OPTION_NOT_SUPPORTED
This service does not accept {param}
O serviço não aceita um campo que você enviou. Corrija a requisição primeiro.
400
DRIP_FEED_NOT_AVAILABLE
Drip-feed is not available for this service
O serviço não tem drip feed, ou não tem para esta quantidade. Corrija a requisição primeiro.
400
DRIP_FEED_CONFLICT
Send runs and interval, or drip_feed_total_minutes, not both
As duas formas de drip feed foram enviadas em uma mesma requisição. Corrija a requisição primeiro.
400
DRIP_FEED_INVALID
{rule}
Os valores de drip feed não cabem nos limites. A mensagem diz qual limite. Corrija a requisição primeiro.
429
ORDER_LIMIT_REACHED
Too many orders. Try again later.
Pedidos demais foram feitos ou estão abertos ao mesmo tempo. Tente de novo mais tarde. Tentar de novo pode ajudar.
409
SERVICE_CHANGED
Service settings changed while placing the order. Retry.
As configurações do serviço mudaram enquanto o pedido era feito. Envie a requisição de novo. Tentar de novo pode ajudar.
409
REQUEST_ID_CONFLICT
request_id was already used with different parameters
Este request_id já criou um pedido com parâmetros diferentes. Corrija a requisição primeiro.

Pedidos e cancelamento

404
ORDER_NOT_FOUND
Order not found
Nenhum pedido com este número pertence à sua conta. Corrija a requisição primeiro.
409
ORDER_FINISHED
Order is already {status}
O pedido já terminou. Corrija a requisição primeiro.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Não é possível cancelar este pedido. Corrija a requisição primeiro.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
A solicitação de cancelamento foi recusada. Você pode pedir de novo depois do tempo em details.time. Tentar de novo pode ajudar.

Reposições

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.

Webhooks

409
WEBHOOK_LIMIT
Maximum {limit} webhook endpoints per account
A conta já tem o número máximo de endpoints de webhook. Corrija a requisição primeiro.
404
WEBHOOK_NOT_FOUND
Webhook not found
Não existe na sua conta nenhum endpoint de webhook com este ID. Corrija a requisição primeiro.
400
INVALID_WEBHOOK_URL
Invalid webhook URL
A URL não é um endereço https público. Corrija a requisição primeiro.