{"id":15979,"date":"2015-02-09T10:03:13","date_gmt":"2015-02-09T09:03:13","guid":{"rendered":"http:\/\/puship.com\/?page_id=15979"},"modified":"2020-07-20T17:35:17","modified_gmt":"2020-07-20T16:35:17","slug":"java","status":"publish","type":"page","link":"https:\/\/www.puship.com\/it\/documentazione\/guida-accesso-api\/java\/","title":{"rendered":"Java"},"content":{"rendered":"\n

Utilizzando Java \u00e8 possibile integrarsi con Puship in pochi semplici passi, \u00e8 sufficiente inserire nel proprio progetto il file PushipApi.jar<\/strong>, impostare l’AppId dell’ applicazione con la quale si desidera interagire, lo Username e la Password del vostro profilo Puship, l’EnableDebug(default false), ed il timezone per la conversione delle date.<\/p>\n

 <\/p>\n\n\n\n

<\/path><\/svg><\/div>
Credentials cr = new Credentials(\"MRossi\", \"PassWord\"); \/\/Setta Username, Password e AppId \nCoreApi ca = new CoreApi(\"APKCbOd72fXKVUU\", cr);\n\n\/\/ca.Binarysupport = false; \/\/Da impostare solo quando si utilizza la libreria su Android\nca.EnableDebug = true; \/\/Mostra Url, parametri dell'Url, Codice di Risposta, e la risposta dal Server\n\nPushipUtil.SetTimeZone(\"Europe\/Rome\"); \/\/Setta il Timezone desiderato per convertire le date provenienti da Puship<\/pre><\/div>\n\n\n\n
a questo punto \u00e8 possibile iniziare ad effettuare le chiamate attraverso i seguenti metodi:<\/p>\n
 <\/p>\n
\n
    \n
  1. Lettura delle notifiche<\/a>\n
      \n
    1. Lettura delle notifiche per Piattaforma<\/a><\/li>\n
    2. Lettura delle notifiche per Tag<\/a><\/li>\n
    3. Lettura delle notifiche per Posizione<\/a><\/li>\n
    4. Lettura delle notifiche con Parametri<\/a><\/li>\n
    5. Lettura con aggiunta delle notifiche inviate singolarmente<\/a><\/li>\n
    6. Lettura di tutte le notifiche<\/a><\/li>\n<\/ol>\n<\/li>\n
    7. Lettura delle notifiche per Device<\/a><\/li>\n
    8. Lettura delle App<\/a><\/li>\n
    9. Eliminazione di una notifica<\/a><\/li>\n
    10. Eliminazione dei device<\/a><\/li>\n
    11. Gestione dei Filtri<\/a>\n
        \n
      1. Lettura dei Filtri dell’applicazione<\/a><\/li>\n
      2. Aggiunta di un Filtro al device<\/a><\/li>\n
      3. Rimozione di un Filtro dal device<\/a><\/li>\n
      4. Rimozione di tutti i Filtri del device<\/a><\/li>\n<\/ol>\n<\/li>\n
      5. Lettura dei Device<\/a>\n
          \n
        1. Lettura semplice dei Device<\/a><\/li>\n
        2. Lettura dei Device per Piattaforma<\/a><\/li>\n
        3. Lettura dei Device per Tag<\/a><\/li>\n
        4. Lettura dei Device per Area<\/a><\/li>\n<\/ol>\n<\/li>\n
        5. Invio di una notifica<\/a>\n
            \n
          1. Invio di una notifica per Piattaforma<\/a><\/li>\n
          2. Invio di una notifica per Tag<\/a><\/li>\n
          3. Invio di una notifica per Area<\/a><\/li>\n
          4. Invio di una notifica con Parametri<\/a><\/li>\n<\/ol>\n<\/li>\n
          5. Invio di una notifica per Device<\/a><\/li>\n<\/ol>\n<\/div>\n
             <\/p>\n
            <\/a>Lettura delle notifiche<\/h2>\n
            La lettura delle notifiche pu\u00f2 essere fatta utilizzando dei parametri, anche combinati tra loro. Permettendo cos\u00ec di recuperare ad esempio le push per una determinata piattaforma ed una specifica posizione.<\/p>\n
            Il metodo da utilizzare \u00e8: GetPushMessages(param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            DeviceType<\/strong> int<\/i>: Filtra le notifiche per piattaforma (parametro obbligatorio)<\/p>\n
            Limit<\/strong> int<\/i>: Numero di record massimi ritornati nella chiamata (default 5)<\/p>\n
            Offset<\/strong> long<\/i>: Record di partenza per la lettura paginata (default 0)<\/p>\n
            Tags<\/strong> array di stringhe<\/i>: Filtra le notifiche per tag inviati<\/p>\n
            DeviceId<\/strong> string<\/i>: Aggiunge ai risultati le notifiche inviate ad uno specifico device<\/p>\n
            Latitude<\/strong> double<\/i>: Latitudine della posizione da filtrare<\/p>\n
            Longitude<\/strong> double<\/i>: Longitudine della posizione da filtrare<\/p>\n
            IncludeParams<\/strong> boolean<\/i>: True se si desidera includere i parametri della notifica (default false)<\/p>\n
            Il risultato \u00e8 un array di oggetti contenente i seguenti attributi:<\/p>\n
            PushMessageId<\/strong> string<\/i>: Id della notifica<\/p>\n
            Date<\/strong> datetime<\/i>: Data e ora nel formato json<\/p>\n
            Message<\/strong> string<\/i>: Testo della notifica<\/p>\n
            Params<\/strong> mappa di stringhe<\/i>: Lista dei parametri, possibili Chiavi: Param1, Param2, Param3, Param4, Param5<\/p>\n
             <\/p>\n
             <\/p>\n
            <\/a>Lettura delle notifiche per Piattaforma<\/h3>\n
            Consente di recuperare le notifiche in base alla Piattaforma a cui sono state associate. E’ sufficiente impostare uno dei seguenti valori nel parametro DeviceType<\/strong>:<\/p>\n
            1<\/strong> = Piattaforma Apple<\/p>\n
            2<\/strong> = Piattaforma GCM<\/p>\n
            3<\/strong> = Piattaforma WP7\/8<\/p>\n
            4<\/strong> = BlackBerry<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceType\", \"1\"); \/\/Filtro piattaforma Apple\nJSONArray al = ca.GetPushMessages(map);<\/pre><\/div>\n\n\n\n
            <\/a>Lettura delle notifiche per Tag<\/h3>\n
            Consente di filtrare le notifiche per tag a cui sono state associate. Per default, se non viene impostato nessun tag, vengono restituite tutte le notifiche, indipendentemente dai tag associati.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceType\", \"1\");\nSet tagmaps = new HashSet();\ntagmaps.add(\"Libra\"); \/\/Tag numero 1\ntagmaps.add(\"Virgo\"); \/\/Tag numero 2\nmap.put(\"Tags\", tagmaps);\nJSONArray al = ca.GetPushMessages(map);<\/pre><\/div>\n\n\n\n
            <\/a>Lettura delle notifiche per Posizione<\/h3>\n
            Consente di recuperare le notifiche in base all’area ad esse associate. Per default, se non viene impostata una posizione, vengono restituite tutte le notifiche indipendentemente dall’area associata.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceType\", \"1\");  \nmap.put(\"Latitude\", \"45.44085\"); \/\/latitudine al centro di Venezia\nmap.put(\"Longitude\", \"12.31552\"); \/\/longitudine al centro di Venezia\nJSONArray al = ca.GetPushMessages(map); <\/pre><\/div>\n\n\n\n
            <\/a>Lettura delle notifiche con Parametri<\/h3>\n
            Consente di recuperare le notifiche e i parametri associati. Di default i parametri non vengono inclusi per minimizzare la trasmissione dati.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceType\", \"1\");  \nmap.put(\"IncludeParams\", \"True\");\nJSONArray al = ca.GetPushMessages(map); <\/pre><\/div>\n\n\n\n
            <\/a>Lettura con aggiunta delle notifiche inviate singolarmente<\/h3>\n
            Consente di aggiungere ai risultati dei precedenti filtri tutte le notifiche che il dispositivo ha ricevuto dal momento in cui \u00e8 stato registrato.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceType\", \"1\");\nmap.put(\"DeviceId\", \"APKCbOd72fXKVUU_7a6ff1f023039299\");\nJSONArray al = ca.GetPushMessages(map); <\/pre><\/div>\n\n\n\n
            Questa richiesta restituisce tutte le notifiche push inviate ai dispositivi Apple ed inoltre tutte le notifiche inviate al dispositivo con id APKCbOd72fXKVUU_7a6ff1f023039299<\/i>.<\/p>\n
             <\/p>\n
            <\/a>Lettura di tutte le notifiche<\/h3>\n
            Consente di recuperare tutte le notifiche inviate come vengono visualizzate sulla dashboard di Puship.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"Limit\", \"10\");\nmap.put(\"Offset\", \"0\"); \nmap.put(\"IncludeParams\", \"True\");\nJSONArray al = ca.GetAllPushMessages(map);<\/pre><\/div>\n\n\n\n
            Questa richiesta restituisce tutte le notifiche push aggiungendo i parametri.<\/p>\n
            ATTENZIONE:<\/b> Gli elementi dell’array restituito conterranno anche gli attributi booleani SentToAPNS, SentToBPNS, SentToMPNS, SentToGCM<\/i> che identificano per quale piattaforma \u00e8 stata inviata la notifica<\/p>\n
             <\/p>\n
            <\/a>Lettura delle notifiche per Device<\/h2>\n
            Questa modalit\u00e0 permette di leggere le notifiche inviate ad un determinato device<\/p>\n
            Il metodo da utilizzare \u00e8: GetPushMessagesByDevice (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            DeviceId<\/strong> string<\/i>: Id del Device per il quale si vogliono ottenere le notifiche (obbligatorio)<\/p>\n
            Limit<\/strong> int<\/i>: Numero di record massimi restituiti dalla chiamata (default 5)<\/p>\n
            Offset<\/strong> long<\/i>: Record di partenza per la lettura paginata (default 0)<\/p>\n
            IncludeParams<\/strong> boolean<\/i>: True se si desidera includere i parametri della notifica (default false)<\/p>\n
            Il risultato \u00e8 un array di oggetti contenente i seguenti attributi:<\/p>\n
            PushMessageId<\/strong> string<\/i>: Id della notifica<\/p>\n
            Date<\/strong> datetime<\/i>: Data e ora nel formato json<\/p>\n
            Message<\/strong> string<\/i>: Testo della notifica<\/p>\n
            Params<\/strong> mappa di stringhe<\/i>: Lista dei parametri, possibili Chiavi: Param1, Param2, Param3, Param4, Param5<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceType\", \"1\");\nmap.put(\"DeviceId\", \"APKCbOd72fXKVUU_7a6ff1f023039299\");\nJSONArray al = ca.GetPushMessagesByDevice(map);<\/pre><\/div>\n\n\n\n
            <\/a>Lettura delle App<\/h2>\n
            Questa modalit\u00e0 permette di recuperare la lista delle Applicazioni<\/p>\n
            Il metodo da utilizzare \u00e8: GetApps (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            Limit<\/strong> int<\/i>: Numero di record massimi restituiti dalla chiamata (default 5)<\/p>\n
            Offset<\/strong> long<\/i>: Record di partenza per la lettura paginata (default 0)<\/p>\n
            Il risultato \u00e8 un array di oggetti contenente i seguenti attributi:<\/p>\n
            AccessCode<\/strong> string<\/i>: Id dell’applicazione<\/p>\n
            Created<\/strong> datetime<\/i>: Data e ora di creazione nel formato json<\/p>\n
            Updated<\/strong> datetime<\/i>: Data e ora di ultimo aggiornamento nel formato json<\/p>\n
            Name<\/strong> string<\/i>: Nome dell’applicazione<\/p>\n
            Development<\/strong> boolean<\/i>: True se l’APNS \u00e8 configurato per lo sviluppo, False se \u00e8 configurato per produzione<\/p>\n
            EnableAPNS<\/strong> boolean<\/i>: True se l’APNS \u00e8 configurato<\/p>\n
            EnableBPNS<\/strong> boolean<\/i>: True se l’BPNS \u00e8 configurato<\/p>\n
            EnableMPNS<\/strong> boolean<\/i>: True se l’MPNS \u00e8 configurato<\/p>\n
            EnableGCM<\/strong> boolean<\/i>: True se il GCM \u00e8 configurato<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"Limit\", \"15\");\nmap.put(\"Offset\", \"0\");\nJSONArray al = ca.GetApps(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            ATTENZIONE:<\/b> Questa chiamata non necessita del settaggio dell’AppId (new CoreApi(null, cr);<\/i>)<\/p>\n
             <\/p>\n
             <\/p>\n
            <\/a>Eliminazione di una notifica<\/h2>\n
            Permette di eliminare una notifica in base al suo Id.<\/p>\n
            Il metodo da utilizzare \u00e8: DeletePushMessage (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            PushMessageId<\/strong> string<\/i>: Id della notifica da eliminare (obbligatorio)<\/p>\n
            Il risultato \u00e8 un oggetto contenente i seguenti attributi:<\/p>\n
            Error<\/strong> boolean<\/i>: Ritorna True in caso di errore<\/p>\n
            Message<\/strong> string<\/i>: Messaggio relativo all’errore o all’azione appena conclusa<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"PushMessageId\", \"APKCbOd72fXKVUU_635192605191400000\"); \/\/ Id della notifica da eliminare\nJSONObject al = ca.DeletePushMessage(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Eliminazione dei device<\/h2>\n
            Permette di eliminare una lista di device in base al loro Id.<\/p>\n
            Il metodo da utilizzare \u00e8: DeleteDevices (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            Devices<\/strong> array di stringhe<\/i>: Lista degli id dei device da eliminare (obbligatorio)<\/p>\n
            Il risultato \u00e8 un oggetto contenente i seguenti attributi:<\/p>\n
            Error<\/strong> boolean<\/i>: Ritorna True in caso di errore<\/p>\n
            Message<\/strong> string<\/i>: Messaggio relativo all’errore o all’azione appena conclusa<\/p>\n
            StringParam1<\/strong> string<\/i>: Se l’azione viene completata con successo contiene il numero dei device eliminati<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map =  new HashMap<string, object=\"\">();\n\nSet devicetodelete = new HashSet();\ndevicetodelete.add(\"jS0oE8PtHcVerde_05CD0C12-35A7-4123-8E9F-AA74FF418A18\"); \/\/ Id del device da eliminare\ndevicetodelete.add(\"jS0oE8PtHcVerde_0FDFED66-3CD6-4208-BAA1-90968D1AFA01\"); \ndevicetodelete.add(\"jS0oE8PtHcVerde_7a6ff0f023039299\");\nmap.put(\"Devices\", devicetodelete);\nJSONObject al = ca.DeleteDevices(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Gestione dei Filtri<\/h2>\n
            Questa sezione spiega come poter interagire con i filtri<\/p>\n
             <\/p>\n
            <\/a>Lettura dei Filtri dell’applicazione<\/h3>\n
            Questo metodo permette di leggere i Filtri associati all’applicazione.<\/p>\n
            Il metodo da utilizzare \u00e8: GetAppTagFilters (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            ReturnHystory<\/strong> boolean<\/i>: Se impostato a True la lettura restituisce anche i filtri utilizzati in passato ma che non sono pi\u00f9 associati a nessun device (default false).<\/p>\n
            Il risultato \u00e8 un array di stringhe.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"ReturnHistory\", \"True\");\nJSONArray al = ca.GetAppTagFilters(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
             <\/p>\n
            <\/a>Aggiunta di un Filtro al device<\/h3>\n
            Questo metodo permette di aggiungere un filtro ad un device.<\/p>\n
            Il metodo da utilizzare \u00e8: AddTagFilter (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            DeviceId<\/strong> string<\/i>: Id del Device per il quale si vuole aggiungere il Tag (obbligatorio)<\/p>\n
            Tag<\/strong> string<\/i>: Tag da aggiungere al device (obbligatorio)<\/p>\n
            Il risultato \u00e8 un oggetto contenente i seguenti attributi:<\/p>\n
            Error<\/strong> boolean<\/i>: Ritorna True in caso di errore<\/p>\n
            Message<\/strong> string<\/i>: Messaggio relativo all’errore o all’azione appena conclusa<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceId\", \"jS0oE8PtHcVerde_E57F63B1-E43F-48F0-8A08-149F7168A1DE\");\nmap.put(\"Tag\", \"Libra\");\t\/\/Imposta il tag che vuoi aggiungere\nJSONObject al = ca.AddTagFilter(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
             <\/p>\n
            <\/a>Rimozione di un Filtro dal device<\/h3>\n
            Questo metodo permette di rimuovere un filtro da un device.<\/p>\n
            Il metodo da utilizzare \u00e8: RemoveTagFilter (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            DeviceId<\/strong> string<\/i>: Id del Device per il quale si vuole aggiungere il Tag (obbligatorio)<\/p>\n
            Tag<\/strong> string<\/i>: Tag che si vuole rimuovere dal device (obbligatorio)<\/p>\n
            Il risultato \u00e8 un oggetto contenente i seguenti attributi:<\/p>\n
            Error<\/strong> boolean<\/i>: Ritorna True in caso di errore<\/p>\n
            Message<\/strong> string<\/i>: Messaggio relativo all’errore o all’azione appena conclusa<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceId\", \"jS0oE8PtHcVerde_E57F63B1-E43F-48F0-8A08-149F7168A1DE\");\nmap.put(\"Tag\", \"Libra\");\t\/\/Imposta il tag che vuoi rimuovere\nJSONObject al = ca.RemoveTagFilter(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Rimozione di tutti i Filtri del device<\/h3>\n
            Questo metodo permette di rimuovere tutti filtri da un device.<\/p>\n
            Il metodo da utilizzare \u00e8: CleanTagFilter (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            DeviceId<\/strong> string<\/i>: Id del Device per il quale si vuole aggiungere il Tag (obbligatorio)<\/p>\n
            Il risultato \u00e8 un oggetto contenente i seguenti attributi:<\/p>\n
            Error<\/strong> boolean<\/i>: Ritorna True in caso di errore<\/p>\n
            Message<\/strong> string<\/i>: Messaggio relativo all’errore o all’azione appena conclusa<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceId\", \"jS0oE8PtHcVerde_E57F63B1-E43F-48F0-8A08-149F7168A1DE\"); \/\/Rimuove tutti i tag collegati a questo device\nJSONObject al = ca.CleanTagFilter(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Lettura dei Device<\/h2>\n
            La lettura dei device registrati pu\u00f2 essere filtrata utilizzando svariati parametri, anche combinati fra loro. Per esempio \u00e8 possibile recuperare i device di una determinata piattaforma presenti in una specifica area.<\/p>\n
            Il metodo da utilizzare \u00e8: GetDevices (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            DeviceType<\/strong> int<\/i>: Filtra le notifiche per piattaforma (obbligatorio)<\/p>\n
            Limit<\/strong> int<\/i>: Numero di record massimi restituiti dalla chiamata (default 5)<\/p>\n
            Offset<\/strong> long<\/i>: Record di partenza per la lettura paginata (default 0)<\/p>\n
            Tags<\/strong> array di stringhe<\/i>: Filtra le notifiche per tag inviati<\/p>\n
            Expired<\/strong> boolean<\/i>: Restituisce anche i device con Token scaduto<\/p>\n
            \"Point<\/p>\n
            P1Latitude<\/strong> double<\/i>: Latitudine del Punto 1 della posizione da filtrare<\/p>\n
            P1Longitude<\/strong> double<\/i>: Longitudine del Punto 1 della posizione da filtrare<\/p>\n
            P2Latitude<\/strong> double<\/i>: Latitudine del Punto 2 della posizione da filtrare<\/p>\n
            P2Longitude<\/strong> double<\/i>: Longitudine del Punto 2 della posizione da filtrare<\/p>\n
            LastPositionDate<\/strong> time<\/i>: Data in UTC dalla quale considerare la registrazione della posizione<\/p>\n
            LastPositionNumber<\/strong> int<\/i>: Numero delle ultime posizioni da tenere in considerazione (default infinite)<\/p>\n
            Il risultato \u00e8 un array di oggetti contenente i seguenti attributi:<\/p>\n
            DeviceId<\/strong> string<\/i>: Id del device<\/p>\n
            Expired<\/strong> boolean<\/i>: True se il token \u00e8 scaduto<\/p>\n
            DeviceType<\/strong> int<\/i>: Piattaforma del device<\/p>\n
            Created<\/strong> datetime<\/i>: Data e Ora di prima registrazione del device in formato json<\/p>\n
            Updated<\/strong> datetime<\/i>: Data e Ora di aggiornamento della registrazione in formato json<\/p>\n
             <\/p>\n
             <\/p>\n
            <\/a>Lettura semplice dei Device<\/h3>\n
            La lettura semplice restituisce tutti i device registrati indipendentemente da qualsiasi filtro e piattaforma.<\/p>\n
            Di seguito trovate un esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            JSONArray al = ca.GetDevices();<\/pre><\/div>\n\n\n\n
            <\/a>Lettura dei Device per Piattaforma<\/h3>\n
            Consente di filtrare i device in base ad una piattaforma. E’ sufficiente impostare uno dei seguenti valori nel parametro DeviceType<\/strong>:<\/p>\n
            1<\/strong> = Piattaforma Apple<\/p>\n
            2<\/strong> = Piattaforma Android<\/p>\n
            3<\/strong> = Piattaforma Windows<\/p>\n
            4<\/strong> = BlackBerry<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"DeviceType\", \"1\"); \/\/ Filtro per piattaforma Apple\nJSONArray al = ca.GetDevices(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Lettura dei Device per Tag<\/h3>\n
            Consente di filtrare i device in base ad uno o pi\u00f9 Tag.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nSet tagmaps = new HashSet();\ntagmaps.add(\"Libra\"); \/\/Tag numero 1\ntagmaps.add(\"Virgo\"); \/\/Tag numero 2\nmap.put(\"Tags\", tagmaps);\nJSONArray al = ca.GetDevices(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Lettura dei Device per Area<\/h3>\n
            Consente di filtrare i device in base alle posizione registrate.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map = new HashMap<string, object=\"\">();\nmap.put(\"P1Latitude\", \"40.42163694648697\"); \/\/ Impostiamo l'area di Venezia\nmap.put(\"P1Longitude\", \"10.299156188964844\");\nmap.put(\"P2Latitude\", \"47.45030563100575\");\nmap.put(\"P2Longitude\", \"15.368927001953125\");\nmap.put(\"LastPositionNumber\", \"5\"); \/\/ Vogliamo che la registrazione nell'area di Venezia sia stata effettuata solamente tra le ultime 5 registrazioni\nCalendar c = Calendar.getInstance();\nc.set(2020, 5, 6, 0, 0,0); \/\/ Giugno, 07, 2020\nmap.put(\"LastPositionDate\", c.getTime()); \/\/ Mostra i device registrati dopo la data inserita\nJSONArray al = ca.GetDevices(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Invio di una notifica<\/h2>\n
            L’invio di una notifica pu\u00f2 essere effettuato utilizzando svariati parametri, anche combinati fra loro. Per esempio \u00e8 possibile inviare una notifica per una determinata piattaforma, una specifica area ed un determinato Tag.<\/p>\n
            Il metodo da utilizzare \u00e8: SendPushMessage (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            SendIOS<\/strong> boolean<\/i>: Invia la notifica alla piattaforma IOS (default false)<\/p>\n
            SendAndroid<\/strong> boolean<\/i>: Invia la notifica alla piattaforma Android (default false)<\/p>\n
            SendBB<\/strong> boolean<\/i>: Invia la notifica alla piattaforma BlackBerry (default false)<\/p>\n
            SendWP<\/strong> boolean<\/i>: Invia la notifica alla piattaforma Wp7\/8 (default false)<\/p>\n
            Message<\/strong> string<\/i>: Il messaggio da inviare<\/p>\n
            Badge<\/strong> int<\/i>: Badge associato alla notifica (default 1)<\/p>\n
            Push<\/strong> boolean<\/i>: Imposta l’invio(true) o il solo salvataggio(false) della notifica (default true)<\/p>\n
            Sound<\/strong> string<\/i>: Nome del file da riprodurre all’arrivo della notifica (default Default)<\/p>\n
            Tags<\/strong> Array di stringhe<\/i>: Filtra le notifiche per Tag inviati<\/p>\n
            \"Point<\/p>\n
            P1Latitude<\/strong> double<\/i>: Latitudine del Punto 1 della posizione da filtrare<\/p>\n
            P1Longitude<\/strong> double<\/i>: Longitudine del Punto 1 della posizione da filtrare<\/p>\n
            P2Latitude<\/strong> double<\/i>: Latitudine del Punto 2 della posizione da filtrare<\/p>\n
            P2Longitude<\/strong> double<\/i>: Longitudine del Punto 2 della posizione da filtrare<\/p>\n
            LastPositionDate<\/strong> time<\/i>: Data in UTC dalla quale considerare la registrazione della posizione<\/p>\n
            LastPositionNumber<\/strong> int<\/i>: Numero delle ultime posizioni da tenere in considerazione (default infinite)<\/p>\n
            Params<\/strong> mappa di stringhe<\/i>: Mappa di massimo 5 elementi per inserire parametri generici<\/p>\n
            Il risultato \u00e8 un oggetto contenente i seguenti attributi:<\/p>\n
            Error<\/strong> boolean<\/i>: Ritorna True in caso di errore<\/p>\n
            Message<\/strong> string<\/i>: Messaggio relativo all’errore o all’azione appena conclusa<\/p>\n
            StringParam1<\/strong> string<\/i>: Se l’azione viene completata con successo contiene l\u2019ID della notifica appena creata<\/p>\n
             <\/p>\n
            <\/a>Invio di una notifica per Piattaforma<\/h3>\n
            Consente di inviare o salvare una notifica in base alle piattaforme. E’ necessario impostare almeno uno dei seguenti parametri a true:<\/p>\n
            SendIOS<\/strong><\/p>\n
            SendAndroid<\/strong><\/p>\n
            SendBB<\/strong><\/p>\n
            SendWP<\/strong><\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map =  new HashMap<string, object=\"\">();\nmap.put(\"Message\", \"Push inviata a tutti i device WindowsPhone!\");\nmap.put(\"SendIOS\", \"False\");\nmap.put(\"SendAndroid\", \"False\");\nmap.put(\"SendBB\", \"False\");\nmap.put(\"SendWP\", \"True\");\nJSONArray al = ca.SendPushMessage(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Invio di una notifica per Tag<\/h3>\n
            Consente di inviare o salvare una notifica in base ai Tag per i quali il device si \u00e8 registrato.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map =  new HashMap<string, object=\"\">();\nmap.put(\"Message\", \"Push inviata ai device Android associati ai Tag Virgo o Libra!\");\nmap.put(\"SendIOS\", \"False\");\nmap.put(\"SendAndroid\", \"True\");\nmap.put(\"SendBB\", \"False\");\nmap.put(\"SendWP\", \"False\");\nSet tagmaps = new HashSet();\ntagmaps.add(\"Libra\"); \/\/Tag numero 1\ntagmaps.add(\"Virgo\"); \/\/Tag numero 2\nmap.put(\"Tags\", tagmaps);\nJSONArray al = ca.SendPushMessage(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Invio di una notifica per Area<\/h3>\n
            Consente di inviare o salvare una notifica in base alle posizioni nelle quali il device si \u00e8 registrato.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map =  new HashMap<string, object=\"\">();\nmap.put(\"Message\", \"Push inviata ai device Android registrati a Venezia negli ultimi due mesi\");\nmap.put(\"SendIOS\", \"False\");\nmap.put(\"SendAndroid\", \"True\");\nmap.put(\"SendBB\", \"False\");\nmap.put(\"SendWP\", \"False\");\nmap.put(\"P1Latitude\", \"40.42163694648697\"); \/\/ Impostiamo l'area di Venezia\nmap.put(\"P1Longitude\", \"10.299156188964844\");\nmap.put(\"P2Latitude\", \"47.45030563100575\");\nmap.put(\"P2Longitude\", \"15.36892001953125\")\nCalendar c = Calendar.getInstance();\nc.set(2014, 5, 6, 0, 0,0); \/\/ Giugno, 07, 2014\nmap.put(\"LastPositionDate\", c.getTime());\nJSONArray al = ca.SendPushMessage(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Invio di una notifica con Parametri<\/h3>\n
            Consente di inviare o salvare una notifica con dei parametri generici.<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map =  new HashMap<string, object=\"\">();\nmap.put(\"Message\", \"Push inviata ai device Android con l'aggiunta di 5 parametri generici\");\nmap.put(\"SendIOS\", \"False\");\nmap.put(\"SendAndroid\", \"True\");\nmap.put(\"SendBB\", \"False\");\nmap.put(\"SendWP\", \"False\");\nHashMap<string, object=\"\"> params =  new HashMap<string, object=\"\">(); \/\/ Puoi inserire Testo semplice, urls, pagine da aprire...\nparams.put(\"Param1\", \"Param number 1\");\nparams.put(\"Param2\", \"ttps:\/\/www.facebook.com\/OfficialPuship\");\nparams.put(\"Param3\", \"index.html\");\nparams.put(\"Param4\", \"122.45\");\nparams.put(\"Param5\", \"Special chars:  '%1234567890\\\"!\u00a3$%&\/()=?^\u03b9\u03b8@#\u00b0\u00a7\u03c9-,'\"); \/\/ Max 5 parametri, i successivi sono ignorati\nmap.put(\"Params\", params);\nJSONArray al = ca.SendPushMessage(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            <\/a>Invio di una notifica per Device<\/h2>\n
            Permette di inviare o associare una notifica ad uno o pi\u00f9 device in base al loro Id.<\/p>\n
            Il metodo da utilizzare \u00e8: SendPushMessageByDevice (param)<\/strong><\/p>\n
            I possibili parametri sono:<\/p>\n
            Message<\/strong> string<\/i>: Il messaggio da inviare<\/p>\n
            Badge<\/strong> int<\/i>: Badge associato alla notifica (default 1)<\/p>\n
            Push<\/strong> boolean<\/i>: Imposta l’invio(true) o il solo salvataggio(false) della notifica (default true)<\/p>\n
            Sound<\/strong> string<\/i>: Nome del file da riprodurre all’arrivo della notifica (default Default)<\/p>\n
            Devices<\/strong> array di stringhe<\/i>: Id dei device ai quali inviare la notifica (almeno un elemento obbligatorio)<\/p>\n
            Params<\/strong> mappa di stringhe<\/i>: Mappa di massimo 5 elementi per inserire parametri generici<\/p>\n
            Il risultato \u00e8 un oggetto contenente i seguenti attributi:<\/p>\n
            Error<\/strong> boolean<\/i>: Ritorna True in caso di errore<\/p>\n
            Message<\/strong> string<\/i>: Messaggio relativo all’errore o all’azione appena conclusa<\/p>\n
            StringParam1<\/strong> string<\/i>: Se l’azione viene completata con successo contiene l\u2019ID della notifica appena creata<\/p>\n
            Esempio:<\/p>\n\n\n\n
            <\/path><\/svg><\/div>
            HashMap<string, object=\"\"> map =  new HashMap<string, object=\"\">();\nmap.put(\"Message\", \"Push inviata a due specifici device\");\nSet devicetosend = new HashSet();\ndevicetosend.add(\"APKCbOd72fXKVUU_b87389c9-5e86-45cd-88e0-9cc239643faf\"); \/\/ Device numero 1 (microsoft device)\ndevicetosend.add(\"APKCbOd72fXKVUU_7a6ff0f023039299\"); \/\/ Device numero 2 (android device)\nmap.put(\"Devices\", devicetosend);\nJSONArray al = ca.SendPushMessageByDevice(map);<\/pre><\/div>\n\n\n\n
             <\/p>\n
            Scaricando il file PushipApi.jar trovarei all’interno anche un file di esempio per la configurazione e le chiamate ai vari metodi.<\/p>\n
             <\/p>\n
            Scarica PushipApi.jar + Esempio<\/a><\/p>\n
             <\/p>\n
            Attenzione: La libreria non \u00e8 supportata da versioni di Java inferiori alla 1.6.<\/i>
             <\/p>\n","protected":false},"excerpt":{"rendered":"
            Utilizzando Java \u00e8 possibile integrarsi con Puship in pochi semplici passi, \u00e8 sufficiente inserire nel proprio progetto il file PushipApi.jar, impostare l’AppId dell’ applicazione con la quale si desidera interagire, lo Username e la Password del vostro profilo Puship, l’EnableDebug(default false), ed il timezone per…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":15927,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/15979\/"}],"collection":[{"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/"}],"about":[{"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/types\/page\/"}],"author":[{"embeddable":true,"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/users\/1\/"}],"replies":[{"embeddable":true,"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/comments\/?post=15979"}],"version-history":[{"count":38,"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/15979\/revisions\/"}],"predecessor-version":[{"id":18212,"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/15979\/revisions\/18212\/"}],"up":[{"embeddable":true,"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/pages\/15927\/"}],"wp:attachment":[{"href":"https:\/\/www.puship.com\/it\/wp-json\/wp\/v2\/media\/?parent=15979"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}