Che cos'è il formato di file API?
L'estensione .api identifica un plug-in di Adobe Acrobat - un modulo di estensione binario che aggiunge funzionalità ad Adobe Acrobat o Acrobat Reader su Windows. Nonostante il nome, i file .api non hanno nulla a che fare con il concetto di sviluppo software di «application programming interface» (interfaccia di programmazione di un'applicazione); l'estensione sta semplicemente per Acrobat Plug-In.
Su Windows, un file .api è strutturalmente una standard .DLL (formato Portable Executable, PE32 o PE32+) rinominata con un'estensione diversa. I suoi primi due byte sono sempre 4D 5A - l'intestazione magica ASCII MZ comune a tutti gli eseguibili e le librerie di Windows. Quando Acrobat si avvia, scansiona la sottocartella plug_ins della sua directory di installazione, carica ogni file .api trovato nel proprio processo e chiama il simbolo esportato PlugInMain per inizializzare ogni plug-in.
I plug-in sono scritti in ANSI C o C++ utilizzando l'SDK Core API di Acrobat e sono strettamente legati a livello ABI a una specifica versione principale di Acrobat; un plug-in compilato per Acrobat DC non verrà caricato correttamente in una versione significativamente più vecchia. Gli usi comuni includono flussi di lavoro PDF personalizzati, pannelli per la firma digitale, integrazioni di gestione documentale e livelli DRM aggiunti da strumenti di pubblicazione.
Su macOS, Acrobat utilizza pacchetti .acroplugin invece dei file .api - non esiste alcun file .api su quella piattaforma. I file possono recare una firma digitale Authenticode dell'editore, ma per il resto non sono crittografati né compressi.
Sicurezza e incolumità
RISCHIO: HIGHUn plug-in .api è codice nativo che viene eseguito all'interno di Acrobat con gli stessi privilegi di Acrobat stesso, quindi un file malevolo è pericoloso quanto qualsiasi DLL/EXE non attendibile. Installa i plug-in di Acrobat solo dal fornitore ufficiale o da un editore di cui ti fidi, preferisci plug-in con firma del codice e diffida dei download di «plug-in Acrobat gratuiti» dai portali pubblicitari. Nota la confusione sul nome: chi cerca «aprire file API» spesso si aspetta testo o sorgenti - questa è un'estensione binaria, non documentazione.
Dettagli del formato
in sintesi- API applicazione generica / dati di configurazione - Alcuni programmi non correlati (ad esempio alcuni giochi, MedCalc, certi strumenti di configurazione) scrivono file .api come dati o impostazioni - non sono plug-in di Acrobat.
Programmi che aprono file API
Windows2 apps
Adobe Acrobat Pro (DC)
A pagamento Copia il file .api nella cartella «plug_ins» di Acrobat, quindi riavvia Acrobat; le funzioni del plug-in appariranno nell'interfaccia utente. 
Adobe Acrobat Reader
Gratuito Posiziona il file .api nella cartella «plug_ins» di Reader e riavvia - solo se il plug-in supporta Reader. 
macOS1 app
Adobe Acrobat Pro
A pagamento Installa il pacchetto .acroplugin equivalente nella posizione dei plug-in di Acrobat e riavvia Acrobat (i binari .api di Windows non funzionano su macOS). Dettagli tecnici
specifiche approfondite| Struttura del file | Binario DLL standard Windows PE32/PE32+ con estensione .api al posto di .dll |
| Magic bytes | 4D 5A («MZ») all'offset 0 - l'intestazione stub dell'eseguibile DOS/PE presente in tutte le DLL ed EXE di Windows |
| Ordine dei byte | Little-endian (formato Portable Executable x86/x64) |
| Punto di ingresso esportato | PlugInMain - il simbolo esportato richiesto che Acrobat chiama per inizializzare ogni plug-in dopo il caricamento |
| Meccanismo di caricamento | Acrobat e Reader scansionano la directory «plug_ins» all'avvio e caricano ogni file .api trovato nel processo host |
| Vincolo versione API | Legato all'ABI di una specifica versione principale di Acrobat; un plug-in creato per una release non si caricherà in modo affidabile in una versione significativamente diversa |
| Linguaggio di sviluppo | ANSI C / C++ compilato con gli header e le librerie di importazione dell'SDK Core API di Acrobat |
| Tipo MIME | application/octet-stream |
| Copertura piattaforma | Solo Windows - su macOS, i plug-in di Acrobat sono confezionati come pacchetti .acroplugin, non come file .api |
| Firma del codice | Firma digitale Authenticode opzionale dall'editore del plug-in; checksum PE memorizzato nell'intestazione opzionale |
| Compressione | Binario PE non compresso - le singole sezioni di codice possono essere ottimizzate dal compilatore ma il file non è compresso come archivio |
| Crittografia | Codice macchina nativo non crittografato; la fiducia nell'editore è stabilita tramite la firma opzionale Authenticode, non tramite crittografia |
| Dimensione tipica del file | Da decine di KB a pochi MB, a seconda della complessità del plug-in e delle risorse incluse |
| Casi d'uso comuni | Automazione del flusso di lavoro PDF, pannelli per la firma digitale, applicazione DRM, integrazione della gestione documentale, pipeline di stampa personalizzate |
| Rilasciato | 1990s (Acrobat plug-in architecture) |
| Ultima versione | Tracks the Acrobat SDK / Acrobat DC plug-in API |
| Specifica | opensource.adobe.com |
Conversioni API
Domande e risposte della community
chiesto dagli utentiAncora nessuna domanda - sii il primo a chiedere informazioni sui file API.
