TalentoPay API Help per Sviluppatori

Versione 1.0.1 RC Rev. 31.12.2020

Informazioni di base

Per accedere alle API di TalentoPay è necessario possedere una chiave pubblica ed una chiave privata che vengono rilasciate da TalentoPay si richiesta.

Le chiamate possono devono essere effettuate esclusivamente in modalità GET

I parametri devono essere passati in formato JSON codificati in base64 e assegnati alla variabile "CALL" esempio:
http://api.talentopay.com/v0/getinfo?CALL=eyJwdWJrZXkiOiJBYnIkNDVAMjAyMCIsInByaXZrZXkiOiJlZ

Le risposte del sistema sono sempre in chiaro ed in formato JSON

I seguenti parametri sono obbligatori e devono essere sempre presenti nella fase di chiamata del webservice:

  • Chiave pubblica, parametro "pubkey"
  • Identificativo, parametro "privkey" e composto come segue:
    md5('indirizzo email'+'chiave privata'+md5('password');

Sono disponibili 2 URL per gli endpoint, una operativa ed una per i test:

  • Endpoint di test: https://api.talentopay.com/sandbox
  • Endpoint operativo: https://api.talentopay.com/v0

Monete supportate: Talentocoin: TLC, Talentocash: XTC, Talent: TLT, Bitcoin: BTC, Litecoin: LTC

Funzione getinfo

Restituisce informazioni sulla Blockchain delle moneta desiderata

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC

Esempio dati da inviare in formato JSON: {"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC"}

Restituisce (esempio):
{"coin":"XTC","isvalid":"true","core":15,"version":280771,"protocol":70015,"wallet":130000,"blocks":86589,"connections":4,"difficulty":0.0002441371325370145,
"keypoololdest":1608220303,"keypoolsize":100,"paytxfee":0,"relayfee":1.0e-5,"errors":"","success":true}


Ritorna

Funzione Getnewaddress

Crea un nuovo account e relativo indirizzo di rete per la moneta selezionata

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC

Parametri opzionali (possono non essere inviati):

account = codice account/cod. cliente, se omesso viene generato automaticamente dal sistema

Esempio dati da inviare in formato JSON: {"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC"}


Restituisce (esempio):
{"id":"5","developerid":"1","account":"0X.......","valuta":"XTC","address":"2MtCE5ndT3jVobquP21AVGsj4XUDdy.....","etichetta":"","balance":"0.00000000","created":"2020-12-17 21:18:12","updated":null,"deleted":"0","status":"1","backlink":null,"host":null}


Ritorna

Funzione CheckAddress

Verifica la validità e l'esistenza di un indirizzo

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC
address = L'indirizzo da testare, esempio: address = 2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V

Parametri non obbligatorio:

mode = TRUE o FALSE se non indicato è impostato a FALSE

Esempio dati da inviare in formato JSON: "pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC","mode":true,"address":"2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V"}


Restituisce (esempio):
{"isvalid":true,"address":"2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V","scriptPubKey":"76a9140a66f5050376e82dcfd91fe764ce098b3d59f5e288ac",
"ismine":true,"iswatchonly":false,"isscript":false,"pubkey":"0384c575d01f792620aa614317ae1d42e5bc65d48e26294032f93aeca53b922d3d",
"iscompressed":true,"account":"0XQGDW02E9EC","timestamp":1608220303,"hdkeypath":"m\/0'\/0'\/1'","hdmasterkeyid":"4ab903d7a234217771b89b5f72d03b534b07be3c","success":true,"coin":"XTC"} con mode = TRUE

Restituisce (esempio):
{"isvalid":true,"success":true,"address":"2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V","coin":"XTC"}
con mode = FALSE o senza parametro


Ritorna

Funzione CheckAccount

Verifica la validità di un account e ne restituisce il suo indirizzo di rete

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC
account = codice del conto, esempio: account = 0XQGDW02E9EC

Esempio dati da inviare in formato JSON: {"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC","account":"0XQGDW02E9EC"}


Restituisce (esempio):
{"success":true,"isvalid":true,"address":"2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V","coin":"XTC","error":""}


Ritorna

Funzione GetBalance

Restituisce il saldo del conto

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC
account = codice del conto, esempio: account = 0XQGDW02E9EC

Esempio dati da inviare in formato JSON: {"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC","account":"0XQGDW02E9EC"}


Restituisce (esempio):
{"success":true,"coin":"XTC","account":"0XQGDW02E9EC","address":"2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V","balance":"0.00000000"}


Ritorna

Funzione SendTransaction

Invia una transazione di monete

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC
account = codice del conto, esempio: account = 0XQGDW02E9EC
sendto = indirizzo del wallet a cui spedire le monete,
esempio: sendto = 2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V
amount = importo da inviare nel formato americano (punto per i decimali e virgola per le migliaia)

Esempio dati da inviare in formato JSON: {"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC","account":"0XQGDW02E9EC","amount":0.1,"sendto":"2NBpA14p73dzpSMTQcJeuCnUohFtkFhYDFS"}


Restituisce (esempio):
{"success":true,"txid":"d6435da4e756254a83eab5456d421f7bb6d7c0db8c62108fb491c6047395fa8a"}


Ritorna

Funzione GetTransaction

Restituisce informazioni relative ad una transazione

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC
txid = identificativo della transazione, esempio txid = 5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad

Esempio dati da inviare in formato JSON:
{"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC","txid":"5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad"}


Restituisce (esempio):
{"success":true,"data":{"id":"1","userid":"0","account":"0XQGDW02E9EC","dtime":"2020-12-19 08:12:53","description":"Transazione ricevuta ","dettaglio":"Transazione confermata ID 5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad",
"amount":"0.10000000","credit":"0","category":"receive","balance":"0.79944520","address_start":null,
"address_destination":"2MtCE5ndT3jVobquP21AVGsj4XUDdyMH26V","txblock":"86585",
"hash":"db995e09958b2e119f2ea6f15ada11e18bec376035e8ae526690bc46c576caf3","conferme":"3","valuta":"XTC","status":"2","tipo":"0",
"txid":"5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad","timereceived":"1608363833","developerid":null,"plattform":null}}


Ritorna

Funzione GetTransactions

Restituisce informazioni relative alle transazioni di un utente
Posso ottenerle per una specifica moneta o per tutte le monete utilizzate dall'utente
i dati restituiti vengono ordinati a partire dalla data più recente

Parametri obbligatori:

account: codice dell'account dell'utente

Parametri opzionali (possono non essere inviati):

coin = sigla della moneta
limit = limita il numero di record restituiti max 1000 record, default 100 record.
offset = imposta da quale record partire default è 0

Esempio dati da inviare in formato JSON:
{"pubkey":"chiave pubblica","privkey":"codifica chiave","account":"RQVFO07GU1RR", "coin":"TLC","limit":"10", "offset":"5"}



Ritorna

Funzione GetConfirmation

Restituisce il numero di conferme di una transazione

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC
txid = identificativo della transazione, esempio txid = 5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad

Esempio dati da inviare in formato JSON:
{"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC","txid":"5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad"}


Restituisce (esempio): {"success":true,"confirmations":33}


Ritorna

Funzione GetBlock

Restituisce il numero di blocco e le informazioni sulla transazione

Parametri obbligatori:

coin = sigla della moneta, esempio: coin = XTC
txid = identificativo della transazione, esempio txid = 5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad

Esempio dati da inviare in formato JSON:
{"pubkey":"chiave pubblica","privkey":"codifica chiave","coin":"XTC","txid":"5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad"}


Restituisce (esempio): {"success":true,"block":86585,"data":{"hash":"db995e09958b2e119f2ea6f15ada11e18bec376035e8ae526690bc46c576caf3","confirmations":33,"strippedsize":567,"size":567,"weight":2268,"height":86585,"version":538575872,"versionHex":"201a0400","merkleroot":"bce956db9d4c334651e1a1d804ae6cd464be0842c74d8965f374f7edf944c1e4","tx":["2cba9e34059e17c1c559988ad49ca63cb5b917f4cc2e90d0a1ce792d7da7b7f2","5d98c33474f071fbbabc3f2fbea27f460844ad43810ec3f6177115ba751b67ad"],"time":1608365295,"mediantime":1608316115,"nonce":0,"bits":"1e0fffff","pow_hash":"ab17de97b175a4498284b8dd54db2395a634acb54f1b6e84701652420d742d9a","pow_algo_id":2,"pow_algo":"groestl","difficulty":0.0002441371325370145,"chainwork":"fffff9577e1b2cf2ad04bf299abb457c811d3ce5c9d94d5214ebc824395d357c","previousblockhash":"4ef161cbaceab58ed02477887183570fd313dafbfcce3d4464fa686a68d015bd","nextblockhash":"f996c81bdc58fe9919b53f82857d1678cda00985ba2dc98a08f9c22378dd73b5"}}


Ritorna