# Base URL

> Gli ambienti di staging e di produzione e come comporre l'URL di ogni chiamata.

Pagina HTML: https://app.billyssw.it/documentazione/ambienti  
Indice della documentazione: https://app.billyssw.it/documentazione/index.md  
Tutta la documentazione in un file: https://app.billyssw.it/documentazione/full.md

## Base URL

Gli ambienti dell'API fiscale e l'host da anteporre a ogni percorso del riferimento REST.

### Ambienti

| Ambiente | Base URL | Uso |
| --- | --- | --- |
| Staging | https://pem-staging.billyssw.it | Sviluppo e collaudo dell'integrazione. I documenti emessi non hanno valore fiscale. |
| Production | da definire | Esercenti reali: ogni documento emesso è trasmesso all'Agenzia delle Entrate. |

### Comporre l'URL

I percorsi del riferimento REST sono relativi al base URL: l'endpoint `GET /api/pem` in staging è

GET /api/pem

```bash
curl https://pem-staging.billyssw.it/api/pem \
  -H "Authorization: Bearer <access_token>" \
  -H "Accept: application/json"
```

Tieni il base URL in configurazione: il passaggio in produzione cambia solo quello, percorsi e payload restano identici. Gli esempi di questa documentazione usano l'host di staging.

Importante

Host e client OAuth di produzione sono da definire: li ricevi con l'abilitazione alla produzione, da chiedere a [api@sender.it](mailto:api@sender.it) a collaudo concluso.