Prima di iniziare
Serve un account con piano attivo. Da Impostazioni genera una chiave ABMCraft: è distinta dalla chiave del fornitore AI. Conservala nel sistema che effettua la richiesta; non inserirla in pagine pubbliche o codice del browser.
Le richieste usano il fornitore AI configurato per quel workspace e consumano la disponibilità del piano. Una generazione fallita viene rimborsata nella quota; la fatturazione del fornitore AI segue le sue condizioni.
Richiesta
Metodo: POST · Endpoint: https://www.abmcraft.com/api/campaigns
Header: Content-Type: application/json e X-Api-Key: LA_TUA_CHIAVE_ABMCRAFT.
{
"prospect_name": "Mario Rossi",
"company": "Studio dimostrativo",
"headline": "Consulente che collega siti e CRM per imprese di servizi",
"about": "Profilo fittizio per illustrare il formato della richiesta.",
"linkedin_url": ""
}Obbligatori: nome e almeno uno fra headline e informazioni. Limiti: nome 100 caratteri, azienda 150, headline 1.000, informazioni 12.000, URL LinkedIn 500. Il corpo JSON non può superare 24 KiB.
Risposta e gestione degli errori
Una risposta 201 contiene success, id, pitch_url e generated_data. Salva l’identificativo e il link; non inoltrare automaticamente il documento senza rivederlo.
401: chiave non valida.402: piano non attivo o disponibilità mensile esaurita.413 / 415 / 422: controlla dimensione, formato JSON e campi.429: limite di richieste; attendi prima di riprovare.502 / 503: servizio AI o salvataggio non disponibili; leggi il messaggio restituito.
Il limite applicativo è 30 richieste di generazione per workspace ogni ora. Configura un’attesa sufficiente per la risposta. Se la connessione cade o scade, controlla prima l’archivio: il server potrebbe aver già salvato la campagna. Per evitare duplicati invia un UUID nell’header X-Request-Id e riutilizzalo soltanto per la stessa richiesta e gli stessi dati. Puoi verificarne lo stato con GET /api/generation-status?request=UUID, usando la stessa chiave del workspace. Una risposta pending non va trattata come un nuovo tentativo; done restituisce il link già salvato. Le API documentate qui riguardano le campagne; il modulo Post LinkedIn si usa dall’area autenticata.
Sostituzione e revoca
Da Impostazioni puoi generare una nuova chiave, invalidando la precedente, oppure revocarla. Non condividere la chiave con altri clienti: identifica il tuo workspace.