In breve: un’agenzia si registra una sola volta, con la propria ragione sociale, e pubblicizza i propri clienti inserendo il nome di ciascuno in Nome visibile agli iscritti. L’agenzia paga, gestisce i crediti e riceve le fatture. Gli sviluppatori possono creare e gestire offerte ed eventi tramite l’API REST di Agilis (https://ads.agilis.dating) con chiavi API ottenute dal Portale pubblicitario; le chiavi di prova sono gratuite e non vengono mai mostrate agli iscritti.
Per le agenzie
- Registri l’agenzia con la sua ragione sociale. → Come registrarsi
- Quando crea un’offerta o un evento, inserisca il nome del cliente in Nome visibile agli iscritti. Gli iscritti vedono il nome del cliente, non il Suo.
- Deve essere autorizzato da ciascun cliente a fare pubblicità per suo conto. In base ai Termini e condizioni pubblicitarie, la responsabilità di ciò ricade sull’agenzia.
Chi paga e chi riceve la fattura
- Paga l’account della Sua agenzia, nella valuta di fatturazione dell’agenzia.
- Ogni persona della Sua agenzia ha un proprio credito e paga con quello. Il credito dell’organizzazione è il totale. → Come funziona il credito
- Fatture e risultati sono intestati alla Sua agenzia, con una fattura per ogni pagamento, così può rifatturare a ciascun cliente.
- Per tenere separata la spesa di ciascun cliente, usi un’offerta o un evento distinto per ogni cliente e rifatturi in base alla relativa fattura.
Ruoli del team
Gli amministratori dell’organizzazione e gli inserzionisti lavorano nel Portale pubblicitario; gli sviluppatori lavorano tramite l’API. Gli sviluppatori non possono creare offerte o eventi nel Portale pubblicitario, ma con le proprie chiavi API possono crearli, pubblicarli e pagarli tramite l’API, e la Sua attività è responsabile dell’uso delle proprie chiavi. La tabella completa si trova in Ruoli e autorizzazioni del team.
L’API REST di Agilis
- URL di base: https://ads.agilis.dating
- Documentazione: www.agilis.dating/api-doc, con esempi in cURL, Python, Node.js e PHP e un assistente per l’API
- Formati leggibili dalle macchine: OpenAPI 3.1 su www.agilis.dating/openapi.json, Markdown su www.agilis.dating/api-doc.md e il testo completo per gli strumenti di IA su www.agilis.dating/llms-full.txt
- Offerte: elencare le Sue categorie e gli interessi; calcolare il prezzo di un’offerta prima di crearla; creare, elencare, mettere in pausa, riprendere ed eliminare offerte; consultare i risultati di ciascuna offerta
- Eventi: visualizzare l’anteprima, pubblicare, elencare, modificare, riprogrammare, annullare ed eliminare eventi; consultare i risultati di ciascun evento
Ottenere una chiave API
- Acceda al Portale pubblicitario come Amministratore organizzazione o Sviluppatore.
- Scelga Modalità di prova o live con l’interruttore in cima alla pagina.
- Vada su Chiavi API → Crea nuova chiave, le assegni un nome e, se lo desidera, una data di scadenza.
- Copi subito la chiave. Non potrà più visualizzarla.
Le chiavi di prova iniziano con pk_test_; quelle live con pk_live_. Ogni persona può avere fino a 10 chiavi per ciascuna modalità. Rigenera sostituisce subito una chiave, quindi aggiorni prima i Suoi sistemi. Invii la chiave nell’intestazione della richiesta x-api-key: x-api-key: pk_test_….
Sviluppare in sicurezza
- Sviluppi e testi con una chiave
pk_test_: le offerte e gli eventi di prova sono gratuiti e non vengono mai mostrati agli iscritti. - Calcoli il prezzo di un’offerta con l’endpoint di stima del prezzo prima di crearla.
- Tenga le chiavi fuori dai repository di codice e dai browser; chiami l’API dal Suo server.
Domande
Un’agenzia può gestire più clienti da un unico account?
Sì. Registri l’agenzia una sola volta e indichi il nome del cliente in ogni offerta o evento.
Ogni cliente può avere una propria fattura?
Le fatture vengono emesse alla Sua agenzia, una per ogni pagamento. Le usi per rifatturare ai Suoi clienti.
Esiste un ambiente sandbox?
Sì. La Modalità di prova, con chiavi pk_test_, è un ambiente sandbox completo. Non viene addebitato nulla e nulla viene mostrato agli iscritti.
Posso collegare strumenti di programmazione basati sull’IA?
Sì. Indirizzi il Suo strumento a www.agilis.dating/api-doc.md o www.agilis.dating/openapi.json.
