LibreMoney

2. Основная часть

2.8. API (RestAPI)

Действия с Альясами

Создание/присвоение альяса

Позволяет вам создать альяс в один запрос. Если данный альяс уже существует , этот запрос присвоит новый URI псевдониму.

Запрос

http://localhost:1400/api/assignAlias?
     secretPhrase=SECRET&
     alias=ALIAS&
     uri=URI&
     fee=FEE&
     deadline=DEADLINE&
     publicKey=PUBKEY&
     referencedTransactionFullHash=TRANSFULLHASH&
     broadcast=BROAD

Где:

• SECRET секретная фраза аккаунта
• ALIAS альяс, который вы хотите создать
• URI текст альяса (на пример http://www.google.com/)
• FEE комиссия (в MilliLm) за транзакцию
• DEADLINE дедлайн для транзакции, задается в минутах
• PUBKEY 64-битный публичный ключ ассоциированный с данным аккаунтом. (опционально)
• TRANSFULLHASH Если Вы хотите сослаться на другую транзакцию(опционально)
• BROAD true или false если это должно быть опубликовано широковещательно (опционально)

'Ответ'

{
     "transactionId":       "TXID"
}
{ 
     "fullHash":                 "FULLHASH", 
     "signatureHash":            "SIGHASH", 
     "transactionBytes":         "TXBYTES", 
     "hash":                     "HASH", 
     "transaction":              "TX", 
     "broadcasted":              BROAD, 
     "unsignedTransactionBytes": "UNTXBYTES" 
}

Пример

Запрос:

http://localhost:1400/api/setAlias?
     secretPhrase=123&
     aliasName=Google&
     aliasURI=http://google.com&
     fee=100000000&
     deadline=1440

Результат:

{ 
     "fullHash":                 "645853ddc55daa2c948f46520b0630d964ce0f40c0ee03515faffce6259d0bae", 
     "signatureHash":            "1e622a64292f8b1fcb1ccf155a42a37a99b89cbcaa725f1200ab55b5ec5f1ca8", 
     "transactionBytes":         "0101fe21d700a005668683e673274c671802492d6f54cdc33d247aa426e7ce...", 
     "hash":                     "580c1bb70d7bcb1eb967c4e86c6c9bfc481641dcce84300a579caf35840e662a", 
     "transaction":              "3218487988112808036", 
     "broadcasted":              true, 
     "unsignedTransactionBytes": "0101fe21d700a005668683e673274c671802492d6f54cdc33d247a..." 
}

Исправлено 22/05/14

Get alias

Возвращает информацию о заданном альясе

Запрос

https://localhost:1400/api/getAlias?
     alias=ALIAS_ID

Где:

• ALIAS_ID альяс который вас интересует
• ALIAS_NAME имя альяса который вас интересует

Ответ

{
     "timestamp":  TIMESTAMP, 
     "aliasName":      "ALIAS", 
     "account":    "ACCOUNT",
     "accountRS":  "ACCOUNTRS",
     "aliasURI":        "URI",
     "alias":      "ALIAS_ID"
}

Где:

• TIMESTAMP метка времени, когда был создан альяс. Задается в секундах, от даты создания генезисного блока
• ALIAS название альяса
• ACCOUNT аккаунт, который владеет альсом
• ACCOUNTRS адрес аккаунта в кодировке Reed-Solomon
• URI адрес, на который указывает псевдоним
• ALIAS_ID идентификатор альяса (id)

Пример

Запрос:

https://localhost:1400/api/getAlias?
     alias=15515279700680480368

Ответ:

{
     "timestamp": 2409343, 
     "alias":     "google", 
     "account":   "5629477397208681336",
     "accountRS": "LMA-FLVS-VRBV-LDPD-6DZ9W",
     "uri":       "http://google.com"
}

Get aliases

Возвращает информацию о всех альясах для указанного аккаунта (начиная с указанной метки времени, если задано)

Запрос

https://localhost:1400/api/getAliases?
     account=ACCOUNT&
     timestamp=TIMESTAMP

Где:

• ACCOUNT аккаунт, список альясов которого вас интересует
• TIMESTAMP время начиная с которого были созданы альясы. Задается в секундах начиная с времени создания генезисного блока.

Ответ

{
     "aliases": [
     {
          "timestamp":  TIMESTAMP, 
          "aliasName":      "ALIAS", 
          "account":    "ACCOUNT",
          "accountRS":  "ACCOUNTRS",
          "aliasURI":        "URI",
          "alias":      "ALIAS_ID"
     },
     {
          ...
     }]
}

Где:

• TIMESTAMP метка времени, когда был создан альяс. Задается в секундах, от даты создания генезисного блока
• ALIAS название альяса
• ACCOUNT аккаунт, который владеет альсом
• ACCOUNTRS адрес аккаунта в кодировке Reed-Solomon
• URI адрес, на который указывает псевдоним
• ALIAS_ID идентификатор альяса (id)

Пример

Запрос:

https://localhost:1400/api/getAliases?
     account=5629477397208681336

Ответ:

{
    "aliases": [
        {
            "timestamp": 2409602,
            "aliasName": "promotion",
            "alias": "11086300057073013586",
            "aliasURI": "",
            "accountRS": "LMA-FLVS-VRBV-LDPD-6DZ9W",
            "account": "5629477397208681336"
        },
        {
            ...
        }
               ]
}

Get alias ID (Не используется)

Возвращает ID определенного алиаса. Реализовано начиная с версии 0.5.4e. Функция не используется с версии клиента 1.1.4.

Запрос

https://localhost:1400/api/getAliasId?
     alias=ALIAS

Где:

• ALIAS — альяс, ID которого вы хотите получить

Ответ

{
     "id":       "ALIAS_ID"
}

'Пример'

Запрос:

https://localhost:1400/api/getAliasId?
     alias=google

Ответ:

{
     "id":       "15515279700680480368"
}

Get alias IDs (Не используется)

Возвращает все ID транзакций алиасов после определенного времени в блокчейне. Функция не используется, начиная с клиента версии 1.1.4

Запрос

https://localhost:1400/api/getAliasIds?
     timestamp=TIMESTAMP

Где:

• TIMESTAMP — время, начиная с которого вы хотели бы видеть определенные алиасы. Выражается в секундах начиная с времени генезис блока

'Ответ'

{
     "aliasIds":       [ARRAY_OF_ALIAS_IDs]
}

Пример

Запрос:

https://localhost:1400/api/getAliasIds?
     timestamp=30000

Результат:

{
     "aliasIds":
               ["12219820415480193342",
               "2284413548488744428",
               "6882945328050210195"...]
}

Исправлено 22/05/14

Get alias URI (Не используемый)

Возвращает целевой URI альяса. Функция не используется, начиная с клиента версии 1.1.4

Запрос

http://localhost:1400/api/getAliasURI?
     alias=ALIAS

Где:

• ALIAS альяс, целевой URI которого Вы хотели бы видеть

'Ответ'

{
     "uri":       "URI_ASSIGNED_TO_ALIAS"
}

Внимание: Возвращенный URI будет ограничен!

Пример

Запрос:

http://localhost:1400/api/getAliasURI?
     alias=Google

Ответ:

{
     "uri":       "http:\/\/google.com"
}

Исправлено 22/05/14

List Aliases (Не испольузется)

Возвращает список алиасов, принадлежащих аккаунту. Функция не используется начиная с клиента версии 1.1.4

Запрос

http://localhost:1400/api/listAccountAliases?
     account=ACCOUNT

Где:

• ACCOUNT — номер аккаунта

'Ответ'

{
     "aliases": 
          [ 
               { 
                    "alias":        "ALIAS",  
                    "uri":          "URI",
                    "account":      "ACCOUNT",
                    "timestamp":    "TIMESTAMP"
               } 
          ] 
}

Пример

Запрос:

http://localhost:1400/api/listAccountAliases?
     account=17157779854388545959

Ответ:

{
     "aliases":
          [
               {
                    "alias":     "testalias",
                    "uri":       "1337",
                    "account":   "17157779854388545959",
                    "timestamp":  2920016
               }
          ]
}