Configurar a Stats API

As traduções são feitas usando IA. Se algumas traduções estão incorretas, por favor nos informe em hello@onelink.to

A Stats API está incluída no Team Plus e no Enterprise. Use-a para coletar as suas estatísticas automaticamente nos seus próprios sistemas.
  1. Passo 1

    Criar uma chave de API

    Em “Settings → Stats API”, adicione um rótulo se quiser, como a ferramenta que vai usar a chave, e escolha Create. Copie a chave quando ela aparecer: ela é mostrada uma única vez.
    Uma conta pode ter cinco chaves. Dê uma a cada ferramenta, para poder revogar uma sem parar as outras.
  2. Passo 2

    Solicitar as suas estatísticas

    Cada requisição pede um tipo de estatística em um período, com a chave no cabeçalho Authorization, ou no endereço como &api_key=… para ferramentas que não conseguem definir cabeçalhos:
    curl -H "Authorization: Bearer ol_stats_…" \
      "https://api.onelink.to/public/stats/device?period=month"
    Troque device por redirect, country, referrer ou utm, e escolha o período: day para ontem, month para os últimos 30 dias ou full para os últimos 400 dias. A resposta lista cada Onelink com as suas estatísticas por dia. A referência completa, com um exemplo de resposta para cada tipo, está em “Settings → Stats API”.
  3. Passo 3

    Buscar uma vez por dia

    As estatísticas cobrem dias completos, contados em UTC, e são preparadas logo após a meia-noite UTC, então uma execução depois das 01:00 UTC é suficiente. Cada chave pode fazer 50 requisições por dia e 5 por minuto.
    Se as estatísticas ainda estiverem sendo preparadas, a resposta é 202 com uma lista vazia. Tente de novo depois de cinco minutos. Isso acontece principalmente na primeira requisição de um tipo de estatística.

Funcionalidades neste guia