# Costo di ogni endpoint

**Trasparenza — il nostro fossato.** DivineAPI, AstrologyAPI, Prokerala applicano un costo fisso di 1 credito per chiamata indipendentemente dalla complessità e non pubblicano una suddivisione dettagliata. AstroWay mostra il costo esatto di ciascuno dei {siteMeta.endpoints}+ endpoint.

<Aside type="tip">
**Come leggere la tabella.** Tutti gli endpoint sono suddivisi in 3 sezioni in base al tipo di carico: lookups statici (dizionari in cache), calcoli (carte, sinastria, previsioni) e attività pesanti / report PDF. Il Tier `½` è il più economico (5 crediti), il Tier `8` il più costoso (10.000 crediti, riservato). La colonna **Free** indica la disponibilità nel piano gratuito: ✓ — disponibile, 🔒 — richiede Indie+.
</Aside>

## Come viene calcolato il costo della chiamata

1. **Il middleware di autenticazione** controlla `req.path` (ad esempio, `/chart`).
2. **Cerca in `endpoint-costs.ts`** il valore esatto dei crediti per quel percorso.
3. **Se non trovato** — fallback sul DEFAULT (10 crediti = Tier 1).
4. **Sottrae i crediti** dai limiti del piano della chiave dopo una risposta positiva (stato 2xx).
5. **Le intestazioni della risposta** includono `X-Credits-Used` (crediti usati), `X-Credits-Remaining`, `X-Credits-Limit`.

**Sconti per cache:** con `X-Cache: HIT` (cache di idempotenza di 5 minuti) i crediti **non vengono sottratti**. Per gli endpoint AI (`/interpret/*`) è previsto uno sconto del 50% su cache hit.

## Tabella completa

<CreditsTable locale="uk" />

## Feedback

Se ritieni che un endpoint sia stato assegnato a un tariffario errato (ad esempio, nel tuo caso impiega più o meno tempo) — scrivi a [hello@astroway.info](mailto:hello@astroway.info) con statistiche reali (X-Request-Id dai tuoi log). Revisioniamo regolarmente la distribuzione dei tariffari in base alla telemetria di produzione.

## Contenuti correlati

- [Crediti e limiti](/rate-limits-credits/) — modello di pagamento, limiti di frequenza delle richieste, cosa fare in caso di superamento
- [Tariffe](/pricing/) — budget mensili di crediti per piano
- [OpenAPI 3.1](/v1/openapi.json) — contratto completo dell'API
