Vai al contenuto

Sistema API per EngageBot.PRO

API EngageBot.PRO

Il Sistema API per EngageBot.PRO è stato realizzato da AlexDev, che come azienda di sviluppo web completa, si occupa anche dello sviluppo di avanzate API REST per sistemi dotati di database relazionali.

Questo genere di API può essere applicato a qualunque sistema pre-esistente, permettendo l’interazione tra sistemi che precedentemente non potevano essere connessi (prova ad immaginare un calendario ed un portale amministrativo, o un sistema di pagamenti automatico ed un bot telegram, o un portale di vendita ed un fornitore automatico, un pannello SMM connesso ad EngageBot.PRO, o molte altre integrazioni)

Un API personalizzata si occupa di trasformare i messaggi inviati da uno dei due sistemi, e convertirlo in un formato “leggibile” per l’altro sistema, in modo che possano dialogare senza interruzioni, rendendo automatici processi che precedentemente non potevano esserlo.

In questo articolo andremo a parlare del Sistema API di EngageBot.PRO, ma è possibile realizzare API per qualsiasi tipologia di sistema.


Come funziona un Sistema API

Come funziona un sistema API (ed il Sistema API per EngageBot.PRO)
Come funziona un sistema API (ed il Sistema API per EngageBot.PRO)

Come già detto sopra, un sistema API è in grado di trasformare delle informazioni contenute in un sistema in qualcosa di leggibile da altri sistemi.

In un prossimo articolo vedremo assieme i dettagli, ma per ora ecco un’idea di cosa possono fare:

  • CREARE nuovi elementi, scrivendo dei dati (ad esempio, aggiungere una nuova foto ad un database)
  • LEGGERE gli elementi, per esempio ottenere una lista di ordini
  • ELIMINARE dei dati, come annullare un post
  • MODIFICARE dati esistenti

Possono essere utilizzate per esempio per creare nuovi ordini all’interno del pannello di un fornitore ogni volta che viene creato un ordine nel proprio sito,

oppure aggiungere una foto su EngageBot.PRO partendo da un sito esterno, e molto altro ancora.


Il Sistema API per EngageBot.PRO

Il sistema API realizzato per EngageBot.PRO non è ancora nella sua fase finale, bensì nella versione 0.5, ma è già in grado di permettere a qualsiasi sistema esterno di automatizzare molte delle funzionalità.

La sua documentazione è stata prodotta e rilasciata con POSTMAN
La sua documentazione è stata prodotta e rilasciata con POSTMAN

Il sistema ora permette di:

  • Leggere l’elenco dei gruppi
  • Ottenere informazioni su un gruppo specifico
  • Leggere la lista utenti
  • Leggere la lista foto
  • Eliminare una foto
  • Leggere la lista foto in attesa
  • Aggiungere una foto in lista d’attesa
  • Eliminare una foto dalla lista d’attesa
  • Leggere l’elenco autodrop
  • Aggiungere un utente autodrop
  • Eliminare un utente autodrop
  • Leggere il LOG autodrop eliminati
  • Leggere l’elenco whitelist
  • Aggiungere un utente whitelist
  • Eliminare un utente whitelist
  • Leggere il LOG whitelist eliminati
  • Leggere l’elenco blacklist
  • Aggiungere un utente blacklist
  • Eliminare un utente blacklist
  • Leggere il LOG blacklist eliminati
  • Leggere l’elenco follow
  • Aggiungere un utente follow
  • Eliminare un utente follow
  • Leggere il LOG follow eliminati

Tutto questo è filtrabile secondo vari filtri, e personalizzabile al 100%, come se l’operazione fosse effettuata dal portale di EngageBot.PRO.

La documentazione è semplice ed intuitiva, ed arriva già con esempi di codice e risposte di vario tipo


Come usare il Sistema API per EngageBot.PRO

Il sistema API per EngageBot.PRO viene utilizzato sfruttando il Token del Bot Telegram come token API, proteggendo quindi l’accesso da malintenzionati:

Solo gli utenti in possesso del token possono quindi effettuare richieste alle API.

L’API permette di effettuare 30 richieste al minuto, e richiede un abbonamento EngageBot.PRO attivo.

ESEMPIO: Aggiungere una foto in lista d’attesa

Il sistema dovrà inviare una richiesta POST alle API di engagebot.pro, contenente il link della foto, ed il gruppo in cui si desidera pubblicarla

curl --location --request POST 'https://api.engagebot.pro/pending_photos' \
--form 'url="https://www.instagram.com/p/CPTpIu6tMay/"' \
--form 'priority="10"' \
--form 'silent_repost="0"' \
--form 'silent_post="0"' \
--form 'reposts="0"' \
--form 'group_id="-1001135535210"'

Il sistema risponderà poi con uno dei seguenti modi:

SUCCESSO del Sistema API per EngageBot.PRO

{
  "success": true,
  "data": {
    "id": "4953374",
    "group_id": "-1001135535210",
    "telegram_user_id": null,
    "reposts": "0",
    "author_username": "alessandrovisintainer",
    "media_id": "2581587931453245106",
    "url": "https://www.instagram.com/p/CPTpIu6tMay",
    "created_timestamp": 1624096759,
    "is_repost": false,
    "priority": "10",
    "silent_repost": "0",
    "silent_post": "0"
  }
}

ERRORE: Non hai accesso a questo gruppo

Nel caso in cui si stia cercando di aggiungere una foto in un gruppo in cui il bot non è admin, l’errore ricevuto sarà il seguente:

{
  "success": false,
  "error": "Unable to access this resource"
}

ERRORE: RICHIESTA SBAGLIATA

Nel caso in cui manchi un campo, o venga specificato un valore sbagliato, la risposta sarà la seguente:

{
  "success": false,
  "error": "Missing Priority property"
}

Conclusioni

Come avrai intuito da questa spiegazione, anche se molto tecnica, utilizzare il sistema API per uno sviluppatore è estremamente semplice, e permette di effettuare qualsiasi operazione.

Avere un sistema API nel proprio sistema permetterà integrazioni con qualsiasi sistema esterno, migliorando l’utilizzo e la qualità dei propri servizi.


Hai capito le nostre potenzialità e siamo in linea con le tue necessità?

Quello descritto in questo articolo è un prodotto creato su misura per un cliente e non viene rivenduto, ma se ti ha fatto capire cosa possiamo realizzare e ti interessa realizzare un TUO PRODOTTO SU MISURA, contattaci ora!

Riceverai il massimo della professionalità ed il miglior servizio, ad un prezzo ridottissimo!


⭐️ METTITI IN CONTATTO CON NOI ⭐️

📞 Telegram: @TheDevAle

👥 Gruppo: @AlexDevGroup

🇮🇹 Canale AlexDev: @AlexDev_IT

🇬🇧 AlexDev Channel: @AlexDev_EN

Lascia un commento

Il tuo indirizzo email non sarà pubblicato.

Questo sito usa Akismet per ridurre lo spam. Scopri come i tuoi dati vengono elaborati.