API Documentazione

Accesso programmatico alle funzionalità di alltools.one. Gestisci snippet, condividi dati e traccia la cronologia tramite 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

La maggior parte degli endpoint richiede l'autenticazione tramite un token JWT Firebase o una chiave API.

Token Bearer (Firebase JWT)

Ottieni un token tramite Firebase Auth, quindi includilo nell'intestazione Authorization:

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

Chiave API (Piano Pro)

Gli utenti Pro possono creare chiavi API dalla dashboard. Includi la chiave nell'intestazione X-API-Key:

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

Code Snippets

Salva e gestisci gli output degli strumenti. Gli utenti gratuiti possono archiviare fino a 5 snippet; gli utenti Pro ottengono archiviazione illimitata.

Crea link condivisibili per i dati degli strumenti. Le condivisioni gratuite scadono dopo 30 giorni (max 5 MB). Le condivisioni Pro non scadono mai (max 50 MB).

Tool History

Traccia l'utilizzo degli strumenti. Utenti gratuiti: ultime 20 voci. Utenti Pro: cronologia illimitata.

API Keys

Gestisci chiavi API programmatiche. Richiede il piano Pro. Massimo 5 chiavi per utente.

Subscriptions

Gestisci abbonamenti Pro tramite integrazione Razorpay.

Error Codes

Codice	Significato	Causa comune
`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

Richieste chiave API

Disponibile nel piano Pro. Le richieste vengono tracciate per chiave API.

Abbonamenti email

5 richieste ogni 60 secondi per indirizzo IP.

Limiti del piano

Funzionalità	Gratuito	Pro
Snippet salvati	15	Illimitato
Voci di cronologia	20	Illimitato
Dimensione max condivisione	5 MB	50 MB
Scadenza condivisione	Never	Mai
Richieste API	—	Unlimited (fair use)
Chiavi 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

La maggior parte degli endpoint richiede l'autenticazione tramite un token JWT Firebase o una chiave API.

Token Bearer (Firebase JWT)

Ottieni un token tramite Firebase Auth, quindi includilo nell'intestazione Authorization:

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

Chiave API (Piano Pro)

Gli utenti Pro possono creare chiavi API dalla dashboard. Includi la chiave nell'intestazione X-API-Key:

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

Error Codes

Codice	Significato	Causa comune
`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

Richieste chiave API

Disponibile nel piano Pro. Le richieste vengono tracciate per chiave API.

Abbonamenti email

5 richieste ogni 60 secondi per indirizzo IP.

Limiti del piano

Funzionalità	Gratuito	Pro
Snippet salvati	15	Illimitato
Voci di cronologia	20	Illimitato
Dimensione max condivisione	5 MB	50 MB
Scadenza condivisione	Never	Mai
Richieste API	—	Unlimited (fair use)
Chiavi API	0	5

API Documentazione

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)

Chiave API (Piano Pro)

Code Snippets

Shares

Tool History

API Keys

Subscriptions

Error Codes

Rate Limits

Richieste chiave API

Abbonamenti email

Limiti del piano

API Documentazione

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)

Chiave API (Piano Pro)

Code Snippets

Shares

Tool History

API Keys

Subscriptions

Error Codes

Rate Limits

Richieste chiave API

Abbonamenti email

Limiti del piano