API Methods: GPG
The methods available here are for GPG key handling.
GetGPGKeys
Get info about GPG keys.
This method takes an optional argument:
-
names.#
: A list of GPG keys to get info for. If this is not provided, the call will return all keys for the account.
Example call:
?action=GetGPGKeys&names.1=mykey
The method returns JSON serialized info on the keys:
[
{
"fingerprint": "aa65:abfd:ffa4:327a:6fa0:6bb1:faa1:83c3:534a:91ee",
"has_secret": false,
"id": 10,
"key_id": "FAA183C3534A91EE",
"name": "mykey"
},
{
"fingerprint": "afd7:2cef:2aa4:b345:0304:0ab4:20ac:3539:5aaf:ffa4",
"has_secret": true,
"id": 1,
"key_id": "20AC35395AAFFFA4",
"name": "sign-key"
}
]
ImportGPGKey
Import a GPG key.
-
name
: Name of the GPG key. It must be unique within the account, start with an alphanumeric character and only contain lowercase letters, numbers and-
or+
signs. -
material
: The text representation of the key.
Example of a valid request:
?action=ImportGPGKey&name=my-key
&material=-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.11 (GNU/Linux)
mQENBE4xHgQBCADESzhTFEYYCOrvxBCnwtdQZa2DNDf/RbgEEOW/XEh3E5j9kUPj
.....
Ci8pOnAXPkVXmT5+um1o8b4bzP4BmGbxemmCdPksJxMt6Qq7n88406M6QPaLj/oz
-----END PGP PUBLIC KEY BLOCK-----
The following error may be raised:
-
DuplicateGPGKey
: A key with same name or fingerprint already exists. -
GPGKeyImportFailed
: Key import failed. -
MultipleGPGKey
: The material contains multiple keys. -
Unauthorised
: The user is not authorised to perform the operation.
The method returns a JSON representation of the stored key:
{
"fingerprint": "a404:34a3:e40c:1add:94fa:31b4:30a7:5431:a2eb:521a",
"key_id": "30A75431A2EB521A",
"id": 11,
"name": "my-key",
"has_secret": true
}
RemoveGPGKey
Remove a GPG key.
-
name
: Name of the GPG key.
Example of a valid request:
?action=RemoveGPGKey&name=my-key
The following error may be raised:
-
UnknownGPGKey
: No GPG key with the specified name exists. -
GPGKeyInUse
: The GPG key is currently used by a pocket and can’t be removed.