Documentação da API

API REST para comprar números virtuais, e-mails temporários e serviços de redes sociais. Autentique com `Authorization: Bearer <sua chave>`.

Baixar OpenAPI (JSON)

Autenticação

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
Base URL: https://centralseguidores.online/api/v1

Limite padrão: 60 requisições/minuto por chave (configurável). Erros seguem o formato {"error":{"code","message"}}.

Endpoints

get/servicesListar serviços/produtos disponíveis

Retorna os produtos ativos com o preço já calculado para a sua conta (plano e regras aplicadas).

type (query)
country (query) ISO2 (ex.: BR)
service (query) slug do serviço (ex.: whatsapp)

Respostas: 200 OK · 401 Erro

post/ordersCriar pedido

Idempotency-Key (header) Evita pedidos duplicados em retentativas

Respostas: 201 Criado · 402 Erro · 409 Erro · 422 Erro

get/ordersListar pedidos

status (query)
limit (query)
cursor (query)

Respostas: 200 OK

get/orders/{id}Consultar pedido

id (path, obrigatório)

Respostas: 200 OK · 404 Erro

post/orders/{id}/cancelCancelar pedido (SMS sem código recebido)

id (path, obrigatório)

Respostas: 200 OK · 409 Erro

post/orders/{id}/finishConcluir ativação SMS

id (path, obrigatório)

Respostas: 200 OK

get/balanceSaldo da conta

Respostas: 200 OK

Exemplos: criar pedido

curl

curl -X POST https://centralseguidores.online/api/v1/orders \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-123" \
  -d '{"product_id":"PRODUCT_ID"}'

javascript

const res = await fetch("https://centralseguidores.online/api/v1/orders", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "pedido-123",
  },
  body: JSON.stringify({ product_id: "PRODUCT_ID" }),
});
const order = await res.json();

php

<?php
$ch = curl_init("https://centralseguidores.online/api/v1/orders");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("API_KEY"),
    "Content-Type: application/json",
    "Idempotency-Key: pedido-123",
  ],
  CURLOPT_POSTFIELDS => json_encode(["product_id" => "PRODUCT_ID"]),
]);
$order = json_decode(curl_exec($ch), true);

python

import os, requests

r = requests.post(
    "https://centralseguidores.online/api/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}", "Idempotency-Key": "pedido-123"},
    json={"product_id": "PRODUCT_ID"},
    timeout=30,
)
order = r.json()