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.
- 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. - 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çalhoAuthorization, 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"Troquedeviceporredirect,country,referrerouutm, e escolha o período:daypara ontem,monthpara os últimos 30 dias oufullpara 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”. - 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 é202com uma lista vazia. Tente de novo depois de cinco minutos. Isso acontece principalmente na primeira requisição de um tipo de estatística.