API Documentação

Acesso programático às funcionalidades do alltools.one. Gira snippets, partilha dados e rastreia o histórico via REST API.

URL base

https://api.alltools.one

Use Cases

CI/CD

Retrieve saved configs in your pipeline

Pull your team's saved JSON / YAML / CSV formatter configs in GitHub Actions or GitLab CI to keep builds consistent.

# .github/workflows/validate.yml
- name: Fetch saved formatter config
  run: |
    curl -sf "https://api.alltools.one/api/snippets?tool=json-formatter&limit=1" \
      -H "X-API-Key: ${{ secrets.ALLTOOLS_API_KEY }}" | jq '.snippets[0].data'

Zapier / n8n

Auto-save processed data to your snippet library

When your automation workflow produces a formatted CSV or JSON, POST it directly as a named snippet for later retrieval.

curl -X POST https://api.alltools.one/api/snippets \
  -H "X-API-Key: ato_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "csv-formatter",
    "title": "Daily Report 2025-01-15",
    "data": { "csv": "name,value\nAlice,42\nBob,99" },
    "tags": ["automated", "daily"]
  }'

Programmatic

Generate permanent share links from your code

Create a shareable link for any formatted output — useful for embedding live data previews in Notion, Slack, or documentation.

curl -X POST https://api.alltools.one/api/shares \
  -H "X-API-Key: ato_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "json-formatter",
    "title": "API Response Sample",
    "data": { "input": "{\"status\":\"ok\",\"result\":42}" }
  }'
# Returns: { "share_url": "https://alltools.one/share/abc123def4", "id": "abc123def4" }

Authentication

A maioria dos endpoints requer autenticação através de um token JWT do Firebase ou uma chave API.

Token Bearer (Firebase JWT)

Obtenha um token através do Firebase Auth e inclua-o no cabeçalho Authorization:

curl https://api.alltools.one/api/auth/profile \
  -H "Authorization: Bearer <firebase_id_token>"

Chave API (Plano Pro)

Os utilizadores Pro podem criar chaves API no painel. Inclua a chave no cabeçalho X-API-Key:

curl https://api.alltools.one/api/snippets \
  -H "X-API-Key: ato_your_key_here"

Code Snippets

Guarde e gira saídas de ferramentas. Os utilizadores gratuitos podem armazenar até 5 snippets; os utilizadores Pro obtêm armazenamento ilimitado.

Crie ligações partilháveis para dados de ferramentas. As partilhas gratuitas expiram após 30 dias (máx. 5 MB). As partilhas Pro nunca expiram (máx. 50 MB).

Tool History

Rastreie a utilização de ferramentas. Utilizadores gratuitos: últimas 20 entradas. Utilizadores Pro: histórico ilimitado.

API Keys

Gira chaves API programáticas. Requer plano Pro. Máximo de 5 chaves por utilizador.

Subscriptions

Gira subscrições Pro através da integração Razorpay.

Error Codes

Código	Significado	Causa comum
`200`	OK	Request succeeded
`201`	Created	Resource created
`400`	Bad Request	Validation error or malformed input
`401`	Unauthorized	Missing or invalid auth token
`403`	Forbidden	Pro plan required or not the resource owner
`404`	Not Found	Resource does not exist
`409`	Conflict	Duplicate resource (e.g. email already subscribed)
`410`	Gone	Share link has expired
`413`	Payload Too Large	Data exceeds size limit (5MB free / 50MB pro)
`429`	Too Many Requests	Rate limit exceeded

Rate Limits

Pedidos de chave API

Disponível no plano Pro. Os pedidos são rastreados por chave de API.

Subscrições de e-mail

5 pedidos por 60 segundos por endereço IP.

Limites do plano

Funcionalidade	Gratuito	Pro
Snippets guardados	15	Ilimitado
Entradas de histórico	20	Ilimitado
Tamanho máx. de partilha	5 MB	50 MB
Validade da partilha	Never	Nunca
Pedidos API	—	Unlimited (fair use)
Chaves API	0	5

Use Cases

CI/CD

Retrieve saved configs in your pipeline

Pull your team's saved JSON / YAML / CSV formatter configs in GitHub Actions or GitLab CI to keep builds consistent.

# .github/workflows/validate.yml
- name: Fetch saved formatter config
  run: |
    curl -sf "https://api.alltools.one/api/snippets?tool=json-formatter&limit=1" \
      -H "X-API-Key: ${{ secrets.ALLTOOLS_API_KEY }}" | jq '.snippets[0].data'

Zapier / n8n

Auto-save processed data to your snippet library

When your automation workflow produces a formatted CSV or JSON, POST it directly as a named snippet for later retrieval.

curl -X POST https://api.alltools.one/api/snippets \
  -H "X-API-Key: ato_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "csv-formatter",
    "title": "Daily Report 2025-01-15",
    "data": { "csv": "name,value\nAlice,42\nBob,99" },
    "tags": ["automated", "daily"]
  }'

Programmatic

Generate permanent share links from your code

Create a shareable link for any formatted output — useful for embedding live data previews in Notion, Slack, or documentation.

curl -X POST https://api.alltools.one/api/shares \
  -H "X-API-Key: ato_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "json-formatter",
    "title": "API Response Sample",
    "data": { "input": "{\"status\":\"ok\",\"result\":42}" }
  }'
# Returns: { "share_url": "https://alltools.one/share/abc123def4", "id": "abc123def4" }

Authentication

A maioria dos endpoints requer autenticação através de um token JWT do Firebase ou uma chave API.

Token Bearer (Firebase JWT)

Obtenha um token através do Firebase Auth e inclua-o no cabeçalho Authorization:

curl https://api.alltools.one/api/auth/profile \
  -H "Authorization: Bearer <firebase_id_token>"

Chave API (Plano Pro)

Os utilizadores Pro podem criar chaves API no painel. Inclua a chave no cabeçalho X-API-Key:

curl https://api.alltools.one/api/snippets \
  -H "X-API-Key: ato_your_key_here"

Error Codes

Código	Significado	Causa comum
`200`	OK	Request succeeded
`201`	Created	Resource created
`400`	Bad Request	Validation error or malformed input
`401`	Unauthorized	Missing or invalid auth token
`403`	Forbidden	Pro plan required or not the resource owner
`404`	Not Found	Resource does not exist
`409`	Conflict	Duplicate resource (e.g. email already subscribed)
`410`	Gone	Share link has expired
`413`	Payload Too Large	Data exceeds size limit (5MB free / 50MB pro)
`429`	Too Many Requests	Rate limit exceeded

Rate Limits

Pedidos de chave API

Disponível no plano Pro. Os pedidos são rastreados por chave de API.

Subscrições de e-mail

5 pedidos por 60 segundos por endereço IP.

Limites do plano

Funcionalidade	Gratuito	Pro
Snippets guardados	15	Ilimitado
Entradas de histórico	20	Ilimitado
Tamanho máx. de partilha	5 MB	50 MB
Validade da partilha	Never	Nunca
Pedidos API	—	Unlimited (fair use)
Chaves API	0	5

API Documentação

URL base

Use Cases

Retrieve saved configs in your pipeline

Auto-save processed data to your snippet library

Generate permanent share links from your code

Authentication

Token Bearer (Firebase JWT)

Chave API (Plano Pro)

Code Snippets

Shares

Tool History

API Keys

Subscriptions

Error Codes

Rate Limits

Pedidos de chave API

Subscrições de e-mail

Limites do plano

API Documentação

URL base

Use Cases

Retrieve saved configs in your pipeline

Auto-save processed data to your snippet library

Generate permanent share links from your code

Authentication

Token Bearer (Firebase JWT)

Chave API (Plano Pro)

Code Snippets

Shares

Tool History

API Keys

Subscriptions

Error Codes

Rate Limits

Pedidos de chave API

Subscrições de e-mail

Limites do plano