Documentazione API

L'utilizzo di questa API è limitato ai programmatori e alle persone con conoscenze tecnologiche avanzate. Qualsiasi funzionalità che si desideri eseguire tramite l'API può essere eseguita anche tramite l'interfaccia Web, quindi se non disponi di conoscenze tecnologiche, prova a utilizzare l'interfaccia Web.

Per potersi identificare con la nostra API è necessario il token di autenticazione. Tieni presente che vedrai queste informazioni solo se hai effettuato l'accesso alla pagina e che questi dati sono esclusivi del tuo account e non personali, non condividerli con nessuno al di fuori della tua organizzazione. I dati che devono essere inclusi in tutte le chiamate sono:

Devi essere loggato per vedere questi valori Entra qui.

La nostra API è in formato REST, quindi è indipendente dalla lingua che verrà utilizzata. Le chiamate vengono sempre effettuate sul seguente endpoint:

https://acumbamail.com/api/1/(nombreFuncion)/

Y a este endpoint es al que se le pasarán los parámetros de entrada. Nuestra recomendación, dado que en la mayoría de los casos se van a realizar modificaciones sobre los datos que están almacenados en la base de datos es que se utilice POST, aunque también tenemos capacidad para soportar llamadas en formato GET.

Tutte le funzioni, oltre ai dati che possono essere restituiti in risposta alla richiesta, restituiranno anche un codice di stato html che potremo acquisire. C'è un codice diverso per ogni situazione e i codici sono i seguenti:

• Código de estado

• 200

  La consultazione ha avuto successo

• 201

  I dati sono stati modificati correttamente

• 400

  Richiesta errata: un qualche argomento è risultato errato

• 401

  Non autorizzato, il processo di autenticazione è stato errato

• 429

  Demasiadas peticiones a una función en un periodo de tiempo

• 500

  Se ha producido algún error en el servidor. Infórmanos para que lo arreglemos

In alcuni casi viene richiesto un dizionario come parametro di input per i metodi. Nel caso delle chiamate POST, tutti i parametri devono andare nel corpo come dati del modulo, per codificare un dizionario nella chiamata GET sarebbe un esempio:

https://acumbamail.com/api/1/(nombreFuncion)/?dict[key]=value&dict[key1]=value1&dict[key2]=value2

Y a este endpoint es al que se le pasarán los parámetros de entrada. Nuestra recomendación, dado que en la mayoría de los casos se van a realizar modificaciones sobre los datos que están almacenados en la base de datos es que se utilice POST, aunque también tenemos capacidad para soportar llamadas en formato GET.