# Agenzie, team e API

Come le agenzie pubblicizzano i clienti su Agilis con il nome di ciascuno, come funzionano ruoli, crediti e fatture e come usare l’API REST di Agilis.

**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

1. **Registri l’agenzia** con la sua ragione sociale. → [Come registrarsi](https://www.agilis.dating/it/business/guide/register)
2. 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.
3. 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](https://www.agilis.dating/it/business/guide/pricing)
- 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](https://www.agilis.dating/it/business/guide/getting-started).

## 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

1. Acceda al Portale pubblicitario come Amministratore organizzazione o Sviluppatore.
2. Scelga **Modalità di prova** o live con l’interruttore in cima alla pagina.
3. Vada su **Chiavi API** → **Crea nuova chiave**, le assegni un nome e, se lo desidera, una data di scadenza.
4. **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.

Source: https://www.agilis.dating/it/business/guide/agencies-and-api