API documentation
BITONIC OAUTH API DOCUMENTATION V0.2
This document describes API version 0 revision number 2.
Website: bitonic.nl
URL to this document: bitonic.nl/api/0/bitonic-oauth
Author: Roy van Zanten & Niels van Groningen
Company e-mail: contact@bitonic.nl
Author e-mail: dev@bitonic.nl
Table of Contents
- Sharing secrets
- Keys & secrets
- Company information
- URL & Required parameters
- URL
- Required parameters
- Optional parameters
- Signing
1. Sharing secrets and info
Bitonic and the partner will share the following values safely:
consumer_key
(max length: 32bytes)
consumer_secret
token_key
token_secret
The consumer_secret and token_secret will be kept secret.
Its essential only bitonic and the partner know these secrets.Sharing information
Bitonic and the partner will also share the following information:
- Company name to show at Bitonic
- A prefix value to show at Bitonic in front of the given ext_data value (like a '@' character if the ext_data value is a twittername) (This value is optional).
- Company logo image in PNG format, preferably with transparent background
- Return url to go back to when the user needs to transfer the regarding bitcoins to Bitonic when selling bitcoins to Bitonic. (This value is optional).
2. URL & Required parameters
Constructing the customer URL
https://bitonic.nl/order
Buying Bitcoins: Perform a request with optional parameter
ordertype=buy
Selling Bitcoins: Perform a request with mandatory parameterordertype=sell
Required parameters
ext_data
your payment data (e.g. payee name)
bitcoinaddress
valid receiving bitcoin addressOptional parameters
ordertype
buy|sell (default: buy)
btc
amount in bitcoin (default: 1)
euros
amount in euroSigning
Sign the request using OAuth 1.0. Adding the following parameters:
oauth_consumer_key
(See 1.1)
oauth_nonce
Random nonce
oauth_signature
The signature
oauth_signature_method
HMAC-SHA1
oauth_timestamp
Current unix timestamp
oauth_token
(See 1.1)
oauth_version
1.0