LogoLogo
v5.0
v5.0
  • 🏠Guida tecnica
  • 🕗Changelog
  • 🔢Setup iniziale
    • Adesione tramite l'Area Riservata
    • Iscrizione al Developer Portal
    • Condivisione configurazione remota
  • Funzionalità
    • 📦Pubblicare un servizio
      • Creare un servizio
      • Provare un servizio in test
      • Revisione del servizio
      • Visibilità del servizio
      • Importare servizi nell'Area Riservata
      • Dati obbligatori
        • Attributi
        • Service Metadata
      • Informazioni sensibili
      • Argomento del servizio
      • Stato del servizio
      • Chiave manage
    • ✉️Inviare un messaggio
      • Messaggi di test
      • Inviare un messaggio tradizionale
      • Inviare un messaggio a contenuto remoto
      • Aggiungere allegati
  • API e specifiche
    • 📐OpenAPI
    • API Servizi
      • Manage Service: Get
      • Manage Service: Get keys
      • Manage Service: Get User Services
      • Manage Service: Create
      • Manage Service: Delete
      • Manage Service: Update
      • Manage Service: Request Review
      • Manage Service: Release
      • Manage Service: Get Released
      • Manage Service: Unpublish
      • Manage Service: Regenerate api key
      • Manage Service: Upload service logo
      • Upload organization logo
      • Service Topics: Get all service topics
    • API Messaggi
      • Get a User Profile using POST
      • Submit a Message passing the user fiscal_code in the request body
      • Get Message
      • Get Subscriptions Feed
      • ⚠️Get a User Profile
      • ⚠️Submit a Message passing the user fiscal_code as path parameter
    • Errori comuni
    • Specifiche API
    • OpenAPI endpoint di recupero dei contenuti remotizzati
  • 🔑Abilitazioni
    • Test con Codici Fiscali reali
    • Test invio avvisi pagoPA
    • Invio messaggi massivo
    • Subscription feed
    • Gestione dei servizi
    • Funzionalità Premium
  • Risorse Utili
    • ❓Supporto agli Enti (tutorial, FAQ)
    • 📘Glossario
Powered by GitBook
On this page
  • Errore 429
  • Errore 400
  • Errore 401
  • Errore 403
  • Errore 404
  1. API e specifiche

Errori comuni

In questa sezione trovi alcuni dei possibili errori a fronte di un invio di una richiesta alle API.

Errore 429

Tutte le API possono restituire lo status code 429 . Questo errore rappresenta un segnale di sovraccarico dell’infrastruttura di IO: in questo caso, è necessario implementare un meccanismo di retry e diminuire il rate delle richieste inserendo delle pause.

Errore 400

{
  "detail": "value [undefined] at [root.0] is not a valid [Exact<NewMessage>]\nvalue [undefined] at [root.1] is not a valid [{ time_to_live: (integer >= 3600 and < 604800 | 604800) }]",
  "status": 400,
  "title": "Invalid (Exact<NewMessage> & { time_to_live: (integer >= 3600 and < 604800 | 604800) })"
}

In questo caso, l’errore è dovuto a un'errata trasmissione del body, come ad esempio un body non inviato nel formato corretto (JSON).

Errore 401

{
  "statusCode": 401,
  "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}

In questo caso, assicurati di aver inserito nell’header il valore corretto della chiave Ocp-Apim-Subscription-Key . Utilizza una delle due chiavi presenti nella sezione "Profilo (sottoscrizioni)" del portale.

{
   "statusCode": 401,
   "message": "Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API."
}

In questo caso, assicurati di avere inserito nell’header della richiesta il valore della chiave Ocp-Apim-Subscription-Key . Utilizza una delle due chiavi presenti nella sezione "Profilo (sottoscrizioni)" del portale.

Errore 403

{
  "detail": "You are not allowed to issue requests for the recipient.",
  "status": 403,
  "title": "Recipient forbidden"
}

In questo caso, assicurati di aver inserito un Codice Fiscale valido o presente nel test.

{
   "detail": "You do not have enough permission to complete the operation you requested",
   "status": 403,
   "title": "You are not allowed here"
}

In questo caso, assicurati di aver inserito un IP valido nella LISTA IP di origine autorizzati del servizio o di aver sottoscritto il contratto aggiuntivo Premium e di aver eseguito le procedure di onboarding previste.

Errore 404

{
  "statusCode": 404,
  "message": "Resource not found"
}

In questo caso, assicurati di aver scritto correttamente il path della richiesta, es: https://api.io.pagopa.it/api/v1/profiles

PreviousSubmit a Message passing the user fiscal_code as path parameterNextOpenAPI endpoint di recupero dei contenuti remotizzati