dodolboks/gist:6c0c54ec6092b90e90b5

## gistfile1.md

      
    Raw
  

              gistfile1.md
            
          
    Spesifikasi API

Data Publisher

api_key = 'grvf1aS06XDvkf2kXC2RVEdaNhgcH2BujtcD42GltgQ'
api_secret = 'bb9b879e5aa4c6c3e495c070eb3442ef3bb392ee4140f44be7dff32c'
Register

Data

api_key
api_secret
nama
email
password

Endpoint
/mitra/api/v1/register/

Output Success
{"meta":{"code":200,"confirm":"success"},"data":{"access_token":"542757fff69d7a53659becfbbbcdfe3e7ffcd564","created":"2014-06-05 14:34:53","expired":"2014-06-07","device_id":"1","os_version":null,"registration_id":null}}

Output Not Success
{"meta":{"code":400,"error_message":"email account has already taken"}}

Login

Data

api_key
api_secret
nama
email
password

Endpoint
/mitra/api/v1/login/

Output Success
{"meta":{"code":200,"confirm":"success"},"data":{"access_token":"542757fff69d7a53659becfbbbcdfe3e7ffcd564","created":"2014-06-05 14:34:53","expired":"2014-06-07","device_id":"1","os_version":null,"registration_id":null}}

Output Not Success
{"meta":{"code":400,"error_message":"Invalid email and password combination"}}

Mengambil List Buku

Deskripsi

Mengambil list buku privat dari publisher mitra
Url

/mitra/api/v1/buku/

Method

GET	

Parameter

api_key (wajib ada)
count

Contoh :

http://webstore.aksaramaya.com:8181/mitra/api/v1/buku/?api_key=grvf1aS06XDvkf2kXC2RVEdaNhgcH2BujtcD42GltgQ

Output

 {
	"meta": {
		"count": 20,
		"total": 6,
		"code": 200,
		"confirm": "oke"
	},
	"data": [
		{
			"id": 1020,
			"isbn": "xxx-xxx-xxx-xxx-x",
			"title": "49 Habits Jualan Online",
			"permalink": "",
			"description": "<p>No Deskripsi</p>",
			"authors": "Yuk Bisnis",
			"published_date": "2014-06-13",
			"cover": "/publication/book/cover/b1a24265ddc72c1370286628b06ad3_175x250.png",
			"sample": "",
			"version": "1",
			"price": 5000,
			"discount_price": 0,
			"publisher_id": 64,
			"library_id": 0,
			"category_id": 79,
			"size": "4 MB",
			"num_pages": 0,
			"status": 1,
			"is_private_library": 1,
			"is_free": 0,
			"bidding_type": 0,
			"end_bidding": null,
			"created": "2014-06-13T22:45:55+00:00",
			"modified": "2014-06-13T23:51:47+00:00",
			"extension": "epub"
		},
	]
 }

Mengambil Detail Buku

Url

/mitra/api/v1/buku/<id>/

Method

GET	

Parameter

- api_key (wajib ada)

Contoh :

http://webstore.aksaramaya.com:8181/mitra/api/v1/buku/1020/?api_key=grvf1aS06XDvkf2kXC2RVEdaNhgcH2BujtcD42GltgQ

Output

{
	"meta": {
		"count": 20,
		"total": 6,
		"code": 200,
		"confirm": "oke"
	},
	"data": {			
			"id": 1020,
			"isbn": "xxx-xxx-xxx-xxx-x",
			"title": "49 Habits Jualan Online",
			"permalink": "",
			"description": "<p>No Deskripsi</p>",
			"authors": "Yuk Bisnis",
			"published_date": "2014-06-13",
			"cover": "/publication/book/cover/b1a24265ddc72c1370286628b06ad3_175x250.png",
			"sample": "",
			"version": "1",
			"price": 5000,
			"discount_price": 0,
			"publisher_id": 64,
			"library_id": 0,
			"category_id": 79,
			"size": "4 MB",
			"num_pages": 0,
			"status": 1,
			"is_private_library": 1,
			"is_free": 0,
			"bidding_type": 0,
			"end_bidding": null,
			"created": "2014-06-13T22:45:55+00:00",
			"modified": "2014-06-13T23:51:47+00:00",
			"extension": "epub"
	},
	
}

POST DATA

Deskripsi

Bila ada user di yubi yang melakukan pembelian buku, dari server yubi mengirim request ke moco dengan detail sebagai berikut:
Url

 /mitra/api/v1/post/

Method

POST	 

Data


email  --> Email yang ingin beli buku
password --> Password untuk membuat user di moco
harga --> harga buku (integer)
api_key
api_secret
book_id --> id Buku
nama --> Nama yang beli buku

Output

Pertama tama kami akan mengecek apakah data user sudah ada di database moco, bila sudah ada, kami akan mengirim output konfirmasi apakah user yang ada di moco itu benar adalah user yang mau beli buku di yubi ini
outputnya:

 {
	"meta":  {
		"code": 200,
		"confirm": "pending"
	},
	"data":  {
	"kode": "qSi4zewgm3W4nGezKiZ83R",
	"expired": "2014-06-14T04:45:26.543509",
	"book_id": "1024",
	"created": "2014-06-14T03:45:26.545703"
    "name": "FeronikaYang",
    "email":"yangferonika@yahoo.com"
	}
 }

Bila mendapat output seperti diatas, dari website yubi bisa menampilkan popup untuk menampilkan informasi apakah user moco diatas memang benar user yubi yang akan membeli buku ini. bila benar (bisa meminta user tersebut untuk klik tombol) dari server yubi mengirim request ke url /mitra/api/v1/sync/ untuk lebih jelasnya bisa lihat opsi SYNC di bawah
Bila ternyata data user yg dikirim belum ada di database kami, maka kami akan membuat user dengan data yang dikirim tersebut.
Berikut Outputnya:
 {
	"meta":  {
	"code": 200,
	"confirm": "beli buku berhasil"
 	},
	"data":  {
	"username": "c_meutia_er@yahoo.com",
	"harga": "5000",
	"password": "sujoko"
 	}
}

SYNC USER

Deskripsi

Sync user merupakan endpoint yg bisa digunakan untuk melakukan konfirmasi untuk pengguna yubi yang akan membeli buku dan msudah mempunyai akun di moco
Url

 /mitra/api/v1/sync/

Data

- api_key
- api_secret
- kode

Method

POST	

CEK USER MOCO

Deskripsi

Untuk mengecek apakah email yg akan dikirim sudah digunakan oleh user mocoa
Url

 /mitra/api/v1/cek/user/

Parameter

- api_key
- email

Method

GET	

Contoh

 http://webstore.aksaramaya.com:8181/mitra/api/v1/cek/user/?api_key=grvf1aS06XDvkf2kXC2RVEdaNhgcH2BujtcD42GltgQ&email=kasino1@gmail.com	

Output

Bila email sudah digunakan oleh user atau user dengan email tersebut sudah ada, maka output nya seperti berikut:
{
	meta: {
		code: 200
		error_message: "Sudah ada user dengan email ini"
	}
}

Berikut output jika emailnya belum di pakai atau belum ada user dengan email tersebut:
{
	meta: {
		code: 404
		error_message: "User tidak ditemukan"
	}
}

CEK USER MITRA

Deskripsi

Untuk mengecek apakah user mitra dengan email yg di maksud pernah melakukan transaksi/sudah membeli buku yg dimaksud.
Url

 /mitra/api/v1/cek/usermitra/

Parameter

- api_key
- email

Method

GET	

Contoh

 http://webstore.aksaramaya.com:8181/mitra/api/v1/cek/usermitra/?api_key=grvf1aS06XDvkf2kXC2RVEdaNhgcH2BujtcD42GltgQ&email=kasino1@gmail.com	

Output

Bila user dengan email tersebut sudah pernah membeli buku, maka output nya seperti berikut:
{
	meta: {
		code: 200
		error_message: "User sudah pernah beli"
	}
}

Berikut output jika emailnya belum di pakai atau belum ada user dengan email tersebut:
{
	meta: {
		code: 404
		error_message: "User belum pernah beli"
	}
}

Web Based

Untuk melihat berapa kali transaksi, jumlah buku dan jumlah user yg sudah melakukan transaksi juga bisa di lihat dari tautan berikut :
http://webstore.aksaramaya.com:8181/mitra/