Guida alla risoluzione dei problemi relativi all’APITroubleshooting guide for API issues

Di seguito sono indicati possibili problemi relativi al modo in cui gli amministratori interagiscono con Azure Mobile Engagement usando le API.The following are possible issues you may encounter with how administrators interact with Azure Mobile Engagement via the APIs.

Problemi di sintassiSyntax issues

ProblemaIssue

  • Errori di sintassi durante l'uso dell'API (o comportamento imprevisto).Syntax Errors using the API (or unexpected behavior).

CauseCauses

  • Problemi di sintassi:Syntax issues:
    • Assicurarsi di controllare la sintassi dell'API in uso per confermare che l'opzione sia disponibile.Make sure to check the Syntax of the specific API you are using to confirm that the option is available.
    • Un problema comune relativo all'utilizzo dell'API si verifica quando vengono confuse le API Reach e Push; la maggior parte delle attività deve essere eseguita tramite l'API Reach anziché l'API Push.A common issue with API usage is to confuse the Reach API and the Push API (most tasks should be performed with the Reach API instead of the Push API).
    • Un altro problema comune relativo all'integrazione dell'SDK e all'utilizzo dell'API si verifica quando vengono confuse le chiavi SDK e API.Another common issue with SDK integration and API usage is to confuse the SDK Key and the API Key.
    • Gli script che si connettono alle API devono inviare dati almeno ogni 10 minuti, altrimenti si verifica il timeout della connessione. Questo errore è comune soprattutto negli script dell'API Monitor che sono in ascolto dei dati.Scripts that connect to the APIs need to send data at least every 10 minutes or the connection will time out (especially common in Monitor API scripts listening for data). Per impedire i timeout, fare in modo che lo script invii un ping XMPP ogni 10 minuti per mantenere attiva la sessione con il server.To prevent timeouts, have your script send an XMPP ping every 10 minutes to keep the session alive with the server.

Vedere ancheSee also

Impossibile usare l'API per eseguire la stessa azione disponibile nell'interfaccia utente di Azure Mobile EngagementUnable to use the API to perform the same action available in the Azure Mobile Engagement UI

ProblemaIssue

  • Un'azione che può essere eseguita dall'interfaccia utente di Azure Mobile Engagement non può essere eseguita dall'API di Azure Mobile Engagement correlata.An action that works from the Azure Mobile Engagement UI doesn't work from the related Azure Mobile Engagement API.

CauseCauses

  • Quando si conferma che è possibile eseguire la stessa azione dall'interfaccia utente di Azure Mobile Engagement, vuol dire che la funzionalità di Azure Mobile Engagement è stata integrata correttamente nell'SDK.Confirming that you can perform the same action from the Azure Mobile Engagement UI shows that you have correctly integrated this feature of Azure Mobile Engagement with the SDK.

Vedere ancheSee also

Messaggi di erroreError Messages

ProblemaIssue

  • Codici di errore che usano l'API visualizzata nel runtime o nei log.Error codes using the API displayed at runtime or in logs.

CauseCauses

  • Di seguito, è riportato un elenco completo di codici di stato API comuni da usare come riferimento e per risolvere i problemi preliminari:Here is a composite list of common API status codes numbers for reference and preliminary troubleshooting:

      200        Success.
      200        Account updated: device registered, associated, updated, or removed from the current account.
      200        Returns a list of projects as a JSON object or an authentication token generated and returned in the response’s body.
      201        Account created.
      400        Invalid parameter or validation exception (check payload for details). The parameters provided to the API or service are invalid. In this case, the HTTP response will embed more details. Make sure to test for the MIME type of the response as the payload can either be plain text or a JSON object.
      401        Authentication error. No user is currently authenticated or connected (check the AppID and SDK key).
      402        Billing lock. The application is either off its quotas or is currently in a bad billing state.
      403        The application is not enabled or the specific API is disabled for this application.
      403        Unauthorized access to the project or application, invalid access key (the key must match the one provided when created).
      403        Campaign specific errors: campaign must be finished (or has already been activated), the suspend action can only be performed on an scheduled campaign, cannot finish a campaign that is not currently “in progress”, campaign must be “in progress” and the campaign’s property named, manual Push must be set to true.
      403        The email address is already associated to another account (a super user for instance). No authentication token will be generated.
      404        Application, device, campaign, or project identifier not found.
      404        Query parameter is invalid JSON or has a field with an unexpected value.
      404        The email address is not associated with an account. Please create or update the account first.
      405        Invalid HTTP method (GET, POST, etc.) or trying to edit a read only segment (i.e. add or update or delete a criterion). A segment becomes read only after it has been computed for the first time.
      409        Name already associated to a different device ID or campaign.
      413        Too many device identifiers (current limit is 1,000), POST URL encoded entity is over 2MB, or the period is too large to be displayed (the server didn’t retrieve the analytics because the user request is for a period that is too large).
      503        Analytics not available yet (the requested information is not computed yet for an application).
      504        The server was not able to handle your request in a reasonable time (if you make multiple calls to an API very quickly, try to make one call at a time and spread the calls out over time).
    

Vedere ancheSee also

Errori invisibili all'utenteSilent failures

ProblemaIssue

  • Non è possibile eseguire l'azione API e non vengono visualizzati messaggi di errore nel runtime o nei registri.API action fails with no error message displayed at runtime or in logs.

CauseCauses

  • Molti elementi verranno visualizzati nell'interfaccia utente di Azure Mobile Engagement se sono integrati nel modo corretto, ma verranno nascosti automaticamente dall'API. Pertanto, è opportuno provare la stessa funzionalità dall'interfaccia utente per verificarne il funzionamento.Many items will be disabled in the Azure Mobile Engagement UI if they aren't integrated correctly, but will fail silently from the API, so remember to test the same functionality from the UI to see if it works.
  • Prima di usare Azure Mobile Engagement e alcune delle funzionalità del servizio, è necessario integrare questi elementi in modo individuale nell'app con l'SDK, eseguendo una procedura separata.Azure Mobile Engagement, and many advanced features of Azure Mobile Engagement you are attempting to use, need to be individually integrated into your app with the SDK as separate steps before you can use them.

Vedere ancheSee also