Authkey.create: Difference between revisions
Jump to navigation
Jump to search
w>Jguillo Created page with 'Creates a new authkey = Info = * Component name: authkey.create * Signature: Requires signature using the sharedkey's private key * Timestamp: Requires ztime parameter = Pa…' |
m 13 revisions imported |
||
(12 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
Creates a new authkey | Creates a new authkey. | ||
= Info = | = Info = | ||
* Component name: authkey.create | * '''Component name:''' authkey.create | ||
* Signature: Requires signature using the sharedkey's private key | * '''Signature:''' Requires signature using the sharedkey's private key | ||
* Timestamp: Requires [[ztime parameter]] | * '''Timestamp:''' Requires [[ztime parameter]] | ||
* '''API trust level''': Standard | |||
= Parameters = | = Parameters = | ||
* sharedkey*: Your application shared key | * '''sharedkey*:''' Your application shared key | ||
* ztime*: Z-Timestamp | * '''ztime*:''' Z-Timestamp | ||
* Required parameter | <nowiki>* Required parameter</nowiki> | ||
= | = Returns = | ||
* '''authkeycreate''' | |||
** '''authkey''': New authkey | |||
** '''privatekey''': Private key associated to the new authkey | |||
'''IMPORTANT:''' You must save this private key for future use. It cannot be obtained again anywhere. If you lose an authkey's private key you will be forced to create a new authkey for the user. | |||
https://api.safecreative.org/v2/ | = Example = | ||
REQUEST: | |||
<nowiki>https://api.safecreative.org/v2/</nowiki> | |||
?'''component'''=authkey.create | ?'''component'''=authkey.create | ||
&'''sharedkey'''=zy9x4ol0ctg3btyswq7b5wi9 | &'''sharedkey'''=zy9x4ol0ctg3btyswq7b5wi9 | ||
&'''ztime'''=1271749822099 | &'''ztime'''=1271749822099 | ||
&signature=4ed86580ab439b56251ed712e2554586b125f0ef | &'''signature'''=4ed86580ab439b56251ed712e2554586b125f0ef | ||
RESPONSE: | |||
<pre> | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<authkeycreate> | |||
<authkey>23j22wtpoguzgzk0fag39sey6</authkey> | |||
<privatekey>1f5lcps1hvpo7y1sw175y5qkp</privatekey> | |||
</authkeycreate> | |||
</pre> | |||
[[Category:API component]] | |||
Latest revision as of 08:07, 7 May 2021
Creates a new authkey.
Info
- Component name: authkey.create
- Signature: Requires signature using the sharedkey's private key
- Timestamp: Requires ztime parameter
- API trust level: Standard
Parameters
- sharedkey*: Your application shared key
- ztime*: Z-Timestamp
* Required parameter
Returns
- authkeycreate
- authkey: New authkey
- privatekey: Private key associated to the new authkey
IMPORTANT: You must save this private key for future use. It cannot be obtained again anywhere. If you lose an authkey's private key you will be forced to create a new authkey for the user.
Example
REQUEST:
https://api.safecreative.org/v2/ ?component=authkey.create &sharedkey=zy9x4ol0ctg3btyswq7b5wi9 &ztime=1271749822099 &signature=4ed86580ab439b56251ed712e2554586b125f0ef
RESPONSE:
<?xml version="1.0" encoding="UTF-8"?> <authkeycreate> <authkey>23j22wtpoguzgzk0fag39sey6</authkey> <privatekey>1f5lcps1hvpo7y1sw175y5qkp</privatekey> </authkeycreate>