API di Calcolo

Balistica interna come API

Invia cartuccia, palla, polvere e carica — ricevi pressione, velocità alla volata, tasso di combustione e altro. La stessa fisica del calcolatore ApexLOAD PRO, pronta per i tuoi strumenti.

Cosa fa l'API

Invii gli ID di una cartuccia, palla e polvere più una carica di polvere in grani o un tasso di riempimento tra 50 e 105 %. Valori opzionali come lunghezza totale massima, lunghezza del bossolo, capacità del bossolo, lunghezza della canna e lunghezza della palla sovrascrivono i nostri valori predefiniti, in pollici o millimetri.

Ricevi

  • Pressione di picco e percentuale della pressione massima consentita
  • Velocità alla volata ed energia alla volata
  • Tasso di combustione della polvere e tasso di riempimento
  • Tempo di permanenza in canna
  • Lo standard di sicurezza utilizzato (C.I.P. o SAAMI) e la carica risolta

Come funziona

  1. 1

    Ottieni una licenza PRO

    L'API è inclusa in ApexLOAD PRO — nessun contratto separato.

  2. 2

    Crea la tua chiave

    In Impostazioni → API crei una chiave personale. Viene mostrata solo una volta; rigenerarla revoca quella vecchia.

  3. 3

    Carica i cataloghi

    Scarica gli elenchi JSON di cartucce, palle e polveri con i loro ID. Le chiamate ai cataloghi sono gratuite.

  4. 4

    Chiama calculate

    Invia tramite POST la tua ricarica e ricevi i risultati come JSON in un secondo.

Esempio di richiesta e risposta

curl -X POST https://apexload.pro/api/public/v1/calculate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cartridge_id": "CID_0042",
    "bullet_id": "BID_13719",
    "powder_id": "PID_0101",
    "fill_rate_pct": 95,
    "barrel_length": 24,
    "safety_standard": "CIP"
  }'
{
  "inputs_used": { "charge_gr": 40.75, "charge_source": "from_fill_rate", ... },
  "results": {
    "muzzle_velocity_fps": 2566,
    "max_pressure_bar": 3402.7,
    "powder_burn_pct": 96.9,
    "fill_rate_pct": 95.0,
    "barrel_time_ms": 1.18,
    "pressure_pct_of_max": 82.0
  },
  "safety": { "status": "ok", "standard": "CIP" },
  "usage": { "calculations_used_last_365_days": 215, "budget": 500 }
}

Riferimento completo dei campi, codici di errore e altri esempi sono in Impostazioni → API dopo aver effettuato l'accesso.

Per chi è

Sviluppatori di app e strumenti

Aggiungi balistica interna verificata ad app per poligoni, gestori di ricariche e strumenti cronografici.

Armaioli e produttori di munizioni

Verifica interi piani di ricarica in batch prima di costruirli o testarli.

Club di tiro e poligoni

Alimenta strumenti interni e servizi per soci con calcoli coerenti.

Utenti avanzati di dati

Esegui ladder e serie ipotetiche da Excel, Python, Make o Zapier.

Dove puoi usarla

  • Il tuo sito web o app mobile
  • Fogli di calcolo e script
  • Sistemi interni di vendita e laboratorio
  • Flussi di lavoro per cronografi e dati da poligono

Limiti e uso corretto

  • Disponibile solo con una licenza ApexLOAD PRO attiva
  • Ogni calcolo conta come 1 dei 500 calcoli annuali della tua licenza
  • Fino a 60 calcoli al minuto e 1.000 al giorno
  • Le chiamate ai cataloghi non utilizzano il tuo budget di calcoli
  • Stesse regole di sicurezza del calcolatore — ricariche sopra il 115 % di riempimento sono bloccate

Domande frequenti

Ho bisogno di un abbonamento separato per l'API?

No. L'API è inclusa in ApexLOAD PRO. Ogni calcolo API utilizza un calcolo del tuo budget annuale.

Posso inviare un tasso di riempimento invece di una carica?

Sì. Invia esattamente uno tra carica in grani o tasso di riempimento (50–105 %). La risposta ti dice quale carica è stata usata.

Quale standard di sicurezza viene utilizzato?

Puoi scegliere C.I.P. o SAAMI. Senza scelta usiamo la preferenza del tuo profilo, altrimenti SAAMI. Se una cartuccia ha solo l'altro standard, la risposta lo indica.

Posso usare unità metriche?

Sì. Imposta l'unità su mm e tutte le lunghezze che invii sono lette come millimetri.

Cosa succede se supero il limite di velocità?

Ricevi HTTP 429 con un valore retry_after che ti dice quando riprovare.

I risultati sostituiscono i dati di ricarica pubblicati?

No. Come ogni simulazione, i risultati sono stime. Inizia sempre con cariche basse e segui i dati pubblicati e le pratiche di ricarica sicure.

Posso mostrare i risultati API sul mio sito web o rivenderli?

Puoi mostrare i risultati nei tuoi strumenti e siti web se sono contrassegnati "Calculated with ApexLOAD PRO" con un link a apexload.pro. La rivendita dei risultati o dei dati del catalogo richiede un accordo separato. Consulta i Termini di utilizzo API.

Inizia a sviluppare con ApexLOAD PRO

Crea la tua chiave nelle Impostazioni ed esegui il tuo primo calcolo in pochi minuti.

Termini API

Ottieni la tua chiave API