Genesis Arbitrage

Genesis Arbitrage · · 3 menit baca

REST API

REST API adalah API yang dibangun dengan gaya REST (Representational State Transfer): setiap kumpulan data adalah resource dengan URL sendiri, metode HTTP menentukan aksinya, dan server tidak menyimpan state klien di antara request. Gaya ini dijelaskan Roy Fielding dalam disertasi doktoralnya pada tahun 2000.

Rincian request

Request untuk funding rate BTC di semua exchange:

curl "https://api.genesisarbitrage.com/v1/funding/rates?coin=BTC" \
  -H "X-API-Key: $GENESIS_API_KEY"
BagianNilaiArti
MetodeGETMembaca data
Base URLhttps://api.genesisarbitrage.com/v1Server dan versi API
Resource/funding/ratesFunding rate exchange
Parametercoin=BTCHanya BTC
HeaderX-API-KeyKey klien

Responsnya JSON: data berisi BTC dengan daftar exchange, masing-masing dengan rate per interval funding (funding_pct) dan rate yang dinormalisasi ke 8 jam (funding_8h_pct). Tanpa coin, resource yang sama mengembalikan semua koin. Field dijelaskan di bagian Funding rate.

Metode dan state

Metode memberi tahu server apa yang harus dilakukan pada resource. Semantik metode ditetapkan oleh standar HTTP, RFC 9110:

Genesis API hanya menyajikan data, jadi semua endpoint-nya adalah GET.

Stateless berarti setiap request membawa semua yang dibutuhkan: key, resource, filter. Server tidak mengingat panggilan sebelumnya dan GET tidak mengubah apa pun, sehingga request bisa diulang setelah timeout atau 503: hasilnya hanya bergantung pada request itu sendiri dan data terkini. Agar tidak mengunduh data yang tidak berubah, Genesis API mengirim ETag: request dengan If-None-Match mendapat 304 jika tidak ada yang berubah.

REST vs WebSocket

REST APIWebSocket
InteraksiRequest dan responsAliran pesan dua arah
Siapa yang memulaiKlienSalah satu pihak, setelah terhubung
Cocok untukSnapshot, filter, riwayatFeed transaksi dan order book
Di Genesis APISetiap endpointTidak ada

Dengan REST, pembaruan didapat lewat polling: program mengulang request pada interval tertentu. Genesis API memperbarui outputnya setiap meta.freshness_sec detik, dari 60 di Trial sampai 5 di Max, jadi polling lebih sering tidak menambah apa pun.

Lihat juga: endpoint, WebSocket, format respons, pelajaran: request API pertama Anda dengan HTTP, header, dan JSON.

Tanya jawab

Apa bedanya REST API dengan API secara umum?

API adalah seperangkat aturan apa pun yang dipakai program untuk saling berkomunikasi. REST API adalah kasus khusus lewat HTTP: resource di URL, metode standar, dan request yang tidak bergantung pada request sebelumnya.

Dalam format apa REST API merespons?

REST tidak menetapkan format: bisa JSON, XML, atau jenis lain. Genesis API merespons dalam JSON dengan kompresi gzip.