Bitcoin dan PHP dengan API Coinbase ' s - Penggunaan Asas

Pernahkah anda berfikir tentang menjual perkhidmatan anda sebagai pertukaran untuk bitcoin? Ia tidak begitu pelik - hari ini, ramai pemain besar sebenarnya melakukannya. Dari OkCupid ke Khanacademy, walaupun WordPress menerima bitcoin. Juga, sesetengah negara memikirkannya sebagai mata wang. Hari ini, kami akan melihat bagaimana untuk menerima pembayaran bitcoin di laman web/aplikasi anda dengan cara yang mudah, dengan API Coinbase (dan SDK).

Takeaways Key

API dan SDK Coinbase membenarkan integrasi ke dalam aplikasi web untuk menerima pembayaran bitcoin. Ia menawarkan dua cara utama integrasi: menggunakan salah satu alat saudagar yang disediakan oleh CoinBase, atau integrasi lengkap perkhidmatan tanpa pergi ke laman web Coinbase.
• API Coinbase Coinbase menawarkan pelbagai fungsi termasuk keupayaan untuk menjual atau membeli bitcoin, menghantar atau meminta bitcoin melalui alamat e -mel atau bitcoin, terima pembayaran bitcoin sebagai saudagar, bitcoin kedai dalam satu atau lebih dompet, mempunyai akses kepada rangkaian mentah bitcoin data, dan mengendalikan pembayaran mikro dan pembayaran berulang.
• Pengesahan untuk API Coinbase boleh dilakukan melalui akses utama API yang mudah dengan rahsia API untuk lebih banyak keselamatan, atau melalui OAuth 2. Sistem utama API disyorkan untuk mereka yang ingin menggunakan akaun mereka sendiri dan membuat perubahan kepadanya, sementara itu OAuth disyorkan untuk mereka yang ingin membiarkan pengguna menggunakan akaunnya melalui aplikasinya.
API Coinbase menawarkan fungsi untuk membuat butang pembayaran, yang boleh disesuaikan mengikut keutamaan pengguna. Ini termasuk keupayaan untuk menetapkan tajuk, jumlah, mata wang, dan kod transaksi untuk pembayaran. Penampilan butang dan URL kembali selepas pembayaran yang berjaya juga boleh disesuaikan.
• Coinbase SDK

Coinbase mempunyai beberapa alat yang menarik dan SDK yang tersedia untuk semua orang, dengan beberapa keadaan harga yang mudah dan berpatutan.

inilah yang perlu anda ketahui mengenai harga:

menerima pembayaran dengan koinbase adalah percuma;

anda perlu membayar yuran (1%) hanya jika anda ingin memindahkan wang ke atas akaun bank anda, tetapi hanya jika jualan anda melebihi $ 1000000 (ya, satu milion dolar);
Pembayaran terkecil yang boleh anda lakukan dalam rangkaian Bitcoin ialah 0.001 BTC. Menggunakan dompet Coinbase, bagaimanapun, had itu turun ke 1 Satoshi (0.00000001 BTC);
• Satu lagi perkara penting (dan menarik) ialah anda boleh memilih untuk mengaktifkan perkhidmatan "pertukaran segera", yang menukarkan jumlah pembayaran bitcoin dengan segera ke dalam mata wang pilihan anda tanpa langkah tambahan, secara automatik. Benar -benar keren jika anda ingin mengelakkan ketidakstabilan mata wang dan memindahkan wang anda sebaik sahaja anda boleh.

yang berkata ... bagaimana kita melaksanakan integrasi ini?

Jenis Integrasi

Sama seperti banyak perkhidmatan pembayaran dalam talian yang lain, Coinbase menawarkan dua cara utama integrasi ke dalam aplikasi web anda. Yang pertama lebih cepat dan lebih mudah. Yang kedua adalah sedikit lebih sukar, tetapi juga menjadi lebih mendalam dan mencukupi untuk projek yang lebih besar.

Jenis integrasi pertama terdiri daripada menggunakan salah satu alat saudagar yang disediakan oleh Coinbase. Anda boleh menggunakan butang, halaman dan bingkai. Jika anda menggunakan CMS atau e-dagang (WordPress, WooCommerce, Magento ...) terdapat banyak plugin untuk kegemaran anda.

yang kedua, yang mana kita akan melihat contoh hari ini, adalah integrasi lengkap perkhidmatan tanpa pergi ke laman web Coinbase untuk menghasilkan beberapa kod butang standard. Malah, kami akan menggunakan SDK PHP tertentu untuk melakukannya.

Apa yang boleh kita lakukan dengan SDK ini? Halaman yang berdedikasi di Coinbase jelas:

• menjual atau membeli bitcoin (atau bertukar dengan mata wang anda);
• menghantar atau meminta bitcoin melalui alamat e -mel atau bitcoin;
• menerima pembayaran bitcoin sebagai saudagar;
• simpan bitcoin anda dalam satu atau lebih dompet;
• Mempunyai akses kepada data rangkaian mentah bitcoin (blok, urus niaga dan sebagainya ...);
• Mengendalikan pembayaran mikro dan pembayaran berulang;

sedikit segalanya.

Pada masa ini, terdapat tiga SDK yang tersedia: untuk Ruby, Java dan PHP. Terdapat juga banyak perpustakaan tidak rasmi untuk bahasa lain (python, .net, node ...). Seperti yang saya katakan sebelum ini, SDK yang akan kami gunakan ialah PHP SDK, yang boleh anda temukan di GitHub.

Nota: Sebelum anda pergi ke langkah seterusnya, saya akan menganggap bahawa anda dapat membuat akaun di Coinbase, atau anda sudah mempunyai satu.

php sdk

Pemasangan

mari kita mulakan dengan pemasangan pakej untuk projek kami. Jika anda melihat halaman GitHub dari SDK, anda tidak akan mendapati apa -apa tentang melakukannya dengan komposer. Walau bagaimanapun, pencarian mudah dengan mudah akan menghasilkan halaman pembungkus pakej Coinbase/Coinbase.

anda boleh memasangnya dengan

{
	    "require": {
	        "coinbase/coinbase": "dev-master"
	    }
	}

dalam fail composer.json anda dan

composer update

Pengesahan

Sebelum memulakan dengan kod mari kita bercakap tentang pengesahan. Coinbase mempunyai dua cara untuk mengesahkan anda sebagai pemaju untuk mengakses kaedah API. Anda boleh memilih akses utama API yang mudah, dengan rahsia API untuk mempunyai lebih banyak keselamatan. Atau, jika anda mahu, anda boleh menggunakan OAuth 2. Perbezaannya bukan hanya mengenai kerumitan, tetapi juga mengenai situasi yang perlu anda hadapi.

Dokumentasi Coinbase agak jelas: Jika anda ingin menggunakan akaun anda dan membuat perubahan kepadanya, anda boleh menggunakan sistem kunci API. Jika anda ingin membiarkan pengguna menggunakan akaunnya melalui aplikasi anda (pelanggan yang anda bina, sebagai contoh), perkara terbaik adalah menggunakan OAuth.

API Key Secret

Membuat kunci API adalah sangat mudah, sebaik sahaja anda mempunyai akaun di Coinbase. Apa yang perlu anda lakukan ialah pergi ke sini dan klik pada "Kunci API Baru".

untuk kali pertama anda, anda mungkin perlu mengesahkan akaun anda dengan authy.

Skrin yang akan anda lihat akan menjadi seperti ini:

anda perlu menentukan akaun yang anda mahu gunakan dan keizinan apa yang anda ingin berikan kepada kunci khusus itu, untuk mendapatkan akses. Juga, anda boleh memilih satu atau lebih IP untuk digunakan sebagai senarai putih. Jika anda tidak menentukan apa -apa, tidak akan ada senarai putih.

Selepas itu, sahkan prosedur dengan mengklik pada "Buat" dan klik pada "Dayakan" apabila anda ingin mengaktifkan kekunci API.

oAuth 2.0

Jika anda mahu menggunakan OAuth 2.0, anda perlu mengikuti prosedur yang sama. Walau bagaimanapun, kali ini anda tidak akan membuat kunci API tetapi aplikasi OAuth. Untuk melakukan itu, pergi ke https://coinbase.com/oauth/applications. Dari sana, klik pada "Buat Aplikasi". Anda akan melihat skrin seperti ini:

Masukkan nama aplikasi anda, pilih ikon jika anda mahu dan tentukan senarai URL untuk operasi redirect masa depan.

Nota: Setiap URL yang anda akan masukkan mesti menggunakan SSL (https: // ...). Semua yang lain akan diabaikan.

berikan ok anda dan anda sudah selesai! Anda akan melihat mesej pengesahan dengan rahsia pelanggan dan pelanggan baru anda. Walau bagaimanapun, perkara tidak berakhir, anda boleh membaca nota lain mengenai pengesahan dari halaman yang berdedikasi.

Kebenaran

Jika anda bekerja dengan API, anda perlu berurusan dengan keizinan, untuk keselamatan yang lebih baik. Di sini anda dapat melihat senarai lengkap:

semua: akses lengkap ke akaun anda;

• Pedagang: Buat butang pembayaran, borang, akses kepada maklumat asas mengenai saudagar, edit maklumat anda dan buat alamat baru;
• baki: akses ke baki sebenar anda;
Butang
• : Buat butang pembayaran;
• Beli: Beli bitcoins;
Kenalan: Dapatkan senarai kenalan anda;
Pesanan: Dapatkan senarai pesanan yang anda terima;
Jual: Jual Bitcoins;
• Transaksi: Dapatkan sejarah urus niaga anda;
• hantar: Hantar sejumlah bitcoin dari akaun anda;
• permintaan: minta bitcoin dari akaun anda;
• pemindahan: Dapatkan sejarah pembelian dan menjual;
• recurring_payments: Dapatkan senarai pembayaran berulang;
• oauth_apps: lihat, buat dan edit aplikasi oAuth;
• Laporan: Dapatkan dan buat laporan baru;
Penggunaan SDK Asas
Sekarang bahawa kami mempunyai SDK kami termasuk dalam projek kami, akses kami ditubuhkan, dan kami tahu apa yang kami perlukan, sudah tiba masanya untuk bermula.

Pertama sekali, mari kita lihat pelaksanaan prosedur pengesahan.

akses melalui kunci API dan rahsia

Tidak ada yang kompleks, hanya satu arahan.

{
	    "require": {
	        "coinbase/coinbase": "dev-master"
	    }
	}

hanya gunakan kunci API dan rahsia API sebagai parameter untuk kaedah withapikey (). Objek Coinbase $ yang dihasilkan adalah yang akan kita gunakan untuk contoh masa depan.

Akses melalui OAuth

Selepas penciptaan permohonan OAuth, perkara seterusnya yang perlu dilakukan ialah membuat objek $ Coinbaseoauth, menyatakan ID pelanggan dan rahsia pelanggan yang kami dapat sebelum ini. Sama seperti contoh ini:

composer update

Selepas pengguna melengkapkan proses kebenaran, dia akan diarahkan ke URL yang ditentukan sebelum ini, semasa persediaan. Parameter kod juga akan ditambah untuk mendapatkan token yang sah.

<span>$coinbase = Coinbase<span>::</span>withApiKey($coinbaseAPIKey, $coinbaseAPISecret);</span>

Kemudian, langkah terakhir akan menjadi penciptaan objek Coinbase $ menggunakan token yang kita ada sekarang.

<span>$coinbaseOauth = new Coinbase_OAuth($_CLIENT_ID, $_CLIENT_SECRET, $_REDIRECT_URL);
</span>	<span>header("Location: " . $coinbaseOauth->createAuthorizeUrl("all"));</span>

Anda boleh menggunakan objek ini dengan cara yang sama anda boleh menggunakan yang anda dapat dari pengesahan utama API, API adalah sama.

Mengakses data anda

Mengakses data anda agak mudah. Apa yang anda perlu lakukan ialah menggunakan pembolehubah pembolehubah $ coinbase sebelum ini.

mari kita lihat bagaimana untuk memeriksa baki anda:

<span>$tokens = $coinbaseOauth->getTokens($_GET['code']);</span>

di sini anda dapat melihat cara mengakses data pengguna:

<span>$coinbase = Coinbase<span>::</span>withOauth($coinbaseOauth, $tokens);</span>

Menggunakan objek Coinbase $ anda juga boleh mendapatkan akses kepada beberapa hartanah saudagar.

<span>echo $coinbase->getBalance() . " BTC";</span>

Nota: Harta logo mengembalikan url logo.

Juga, jika anda mahu, anda boleh mendapatkan senarai kenalan anda menggunakan getContacts ().

<span>$user = $coinbase->getUser()
</span>	
	<span>echo $user->name;
</span>	<span>echo $user->email;
</span>	<span>echo $user->time_zone;
</span>	<span>echo $user->native_currency;</span>

Data Mata Wang

Dengan PHP SDK ini, anda juga boleh mendapatkan akses kepada beberapa data mengenai mata wang.

<span>$user->merchant->company_name;
</span>	<span>$user->merchant->logo;</span>

Kaedah getCurrencies () mengembalikan senarai semua mata wang yang sebenarnya aktif pada sistem, dengan kod ISO mereka.

Inilah cara mendapatkan maklumat mengenai kadar pertukaran:

<span>$response = $coinbase->getContacts("user");
</span>
	<span>foreach($response->contacts as $contact)
</span>	<span>{
</span>		<span>echo $contact;
</span>		<span>// 'guyaddress@provider.com'
</span>	<span>}</span>

GetExchangerate () boleh digunakan kedua -duanya dengan dan tanpa parameter (dengan dua hasil yang berbeza, seperti yang anda lihat).

anda juga boleh mendapatkan beberapa maklumat mengenai harga beli dan menjual dengan getBuyPrice () dan getSellPrice ():

<span>$currencies = $coinbase->getCurrencies();
</span>	<span>echo $currencies[0]->name;</span>

Nota: Harga yang dikembalikan termasuk yuran koin 1% dan bank $ 0.15.

Buat butang pembayaran

Kaedah penciptaan butang pembayaran benar -benar berguna, jika anda menganggap kesukaran pelaksanaan dan hasil akhir. Yang perlu anda lakukan ialah memanggil kaedah CreateButton () dengan set parameter tertentu.

Berikut adalah tandatangan:

<span>$rates = $coinbase->getExchangeRate();
</span>	
	<span>echo $rates->btc_to_usd;
</span>	<span>// is the same as...
</span>	<span>echo $coinbase->getExchangeRate('btc', 'usd');</span>

... dan inilah contoh.

<span>echo $coinbase->getBuyPrice('1');
</span>	<span>// '125.31'
</span>	<span>echo $coinbase->getSellPrice('1');
</span>	<span>// '122.41'</span>

agak mudah, huh?

Parameter nama $ pertama adalah "tajuk" untuk pembayaran yang anda ingin buat. Yang seterusnya, $ harga, adalah jumlah pembayaran yang anda mahukan. Yang ketiga ialah mata wang yang anda mahu gunakan, dan $ custom adalah kod transaksi tertentu yang akan dihantar kembali kepada anda selepas prosedur pembayaran.

Akhirnya, array pilihan $ akan membolehkan anda menyesuaikan butang anda dalam setiap cara: anda akan dapat menyesuaikan penampilan butang atau URL kembali selepas pembayaran yang berjaya, atau yang gagal. Sekiranya anda ingin mengetahui lebih lanjut mengenai itu, saya cadangkan anda melihat halaman khusus pada dokumentasi rasmi.

Sebaik sahaja anda mempunyai butang, mudah untuk mendapatkan kod embed.

{
	    "require": {
	        "coinbase/coinbase": "dev-master"
	    }
	}

Kemudian, anda tidak akan ada kaitan tetapi echo the $ response-> embedhtml.

membungkus

Ini menyimpulkan Bahagian 1 di mana kita meliputi penggunaan asas dan pemasangan Coinbase API SDK. Dalam Bahagian 2, kami akan meliputi penghantaran dan menerima wang, serta membina permohonan sampel kami. Tinggal!

Soalan Lazim (Soalan Lazim) pada Bitcoin PHP dan Penggunaan Asas API Coinbase

Bagaimanakah saya boleh menyediakan API Coinbase untuk Bitcoin PHP? Pertama, anda perlu membuat kunci API dari akaun Coinbase anda. Pergi ke Tetapan, kemudian akses API, dan klik pada "Kunci API Baru". Anda perlu memberikan kata laluan dan kod pengesahan dua faktor anda. Sebaik sahaja kunci API dibuat, anda boleh menggunakannya dalam kod PHP anda untuk berinteraksi dengan API Coinbase. Ingatlah untuk memastikan kunci API anda selamat kerana ia membolehkan akses ke akaun Coinbase anda.

Apakah fungsi asas API Coinbase? Ini termasuk membuat alamat Bitcoin baru, menghantar Bitcoin ke alamat, meminta Bitcoin dari alamat, dan mendapatkan maklumat mengenai alamat Bitcoin. Anda juga boleh mendapatkan maklumat mengenai kadar pertukaran bitcoin semasa dan data harga bersejarah. Tangkap blok dalam kod PHP anda. API akan mengembalikan mesej ralat jika ada yang salah, yang boleh anda tangkap dan mengendalikan dengan sewajarnya. Sebagai contoh, jika API mengembalikan ralat apabila cuba menghantar Bitcoin, anda boleh menangkap ralat ini dan memaparkan mesej kepada pengguna.

Ya, anda boleh menggunakan API Coinbase untuk menerima pembayaran bitcoin di laman web anda. Anda boleh membuat alamat Bitcoin baru untuk setiap transaksi, dan kemudian periksa alamat tersebut untuk pembayaran masuk. Ini membolehkan anda menerima pembayaran bitcoin tanpa perlu mengendalikan mana -mana teknologi blockchain yang mendasari sendiri. kod. Ini membolehkan anda membuat panggilan API tanpa menjejaskan akaun Coinbase sebenar anda. Anda boleh membuat akaun kotak pasir dari laman web Coinbase, dan kemudian gunakan kekunci API dari akaun ini dalam kod ujian anda.

Betapa selamatnya API Coinbase? Semua panggilan API dibuat melalui HTTPS, dan data sensitif disulitkan. Walau bagaimanapun, keselamatan aplikasi anda juga bergantung kepada bagaimana anda mengendalikan kunci API anda dan data sensitif yang lain. Sentiasa pastikan kunci API anda selamat dan tidak pernah berkongsi dengan sesiapa sahaja. dengan mana -mana bahasa pengaturcaraan yang boleh membuat permintaan HTTP. Terdapat juga perpustakaan rasmi dan tidak rasmi yang tersedia untuk beberapa bahasa, termasuk Python, Ruby, dan Java. Had tepat bergantung kepada jenis kunci API yang anda miliki dan sama ada permohonan anda adalah awam atau swasta. Anda boleh mendapatkan lebih banyak maklumat mengenai had kadar dalam dokumentasi API Coinbase. Ini termasuk bilangan panggilan API yang telah anda buat, jumlah data yang telah anda hantar dan terima, dan sebarang kesilapan yang telah berlaku. Anda boleh melihat maklumat ini dari halaman akses API dalam akaun Coinbase anda. Ini termasuk Ethereum, Litecoin, dan Bitcoin Cash. Anda boleh menggunakan API untuk mendapatkan maklumat mengenai kriptografi ini, menghantar dan menerima mereka, dan berdagang mereka di pertukaran Coinbase.

Atas ialah kandungan terperinci Bitcoin dan PHP dengan API Coinbase ' s - Penggunaan Asas. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!