悟空电商

悟空电商是一个支持多店铺的开源电商软件，由开源社区驱动，基于MIT协议。

多设备和终端支持

• iOS
• Android
• 网站
• 适配移动设备访问的网站

目标

• 完整的REST HTTP API
• 易用
• 社区驱动开发和技术支持

开源社区

开源社区开发和维护悟空电商，这是一个虚拟的社区，由一群贡献者组成，贡献的内容包含提出问题、报告错误、贡献代码和赞助。

状态

筹备中

需求

• PHP 5.4+
• Laravel 4.2
• MySQL
• zircote/swagger-php
• jlapp/swaggervel
• lucadegasperi/oauth2-server-laravel
• kalnoy/nestedset
• allovince/evathumber
• rmccue/requests

开发需求

• phpunit

安装步骤

创建数据库

CREATE DATABASE IF NOT EXISTS gkcommerce DEFAULT CHARSET utf8 COLLATE utf8_general_ci;

安装mysql结构

$ php artisan migrate

开发指南

安装调试数据

php artisan db:seed
php artisan db:seed --class=ClientsTableSeeder

API

地址

获得用户的所有地址

GET /api/address

获得用户的某一条地址

GET /api/address/{id}

新增一个地址

POST /api/address

删除一个地址

DELETE /api/address/{id}

结算

购物车

分类

商品

用户

获得用户信息

GET /api/user/{id}

获得用户头像

POST /user/avatar/

获得用户header photo

POST /user/header_photo/

注册用户

获取注册的验证码

GET /api/signup/verfication

注册用户

POST /api/signup

OAuth

密码认证

curl http://127.0.0.1:8000/oauth/access_token -X POST -d "grant_type=password&username=swagger&password=swagger&client_id=swagger&client_secret=swagger"

curl http://127.0.0.1:8000/oauth/authorize -X POST -d "response_type=token&redirect_uri=http://127.0.0.1/o2c.html&client_id=swagger&scope=read:user"

Access token

通过header发送

curl http://127.0.0.1:8000/api/ -H "Authorization: OAUTH_TOKEN"

通过参数

curl http://127.0.0.1:8000/api/?access_token=OAUTH_TOKEN

错误信息格式

{
	"message": "",
	"errors": [
		{
			"resource": "Address",
			"field": "name",
			"code": "Required",
			"message": "这个字段是必须的"
		}
	]
}

License

Released under the MIT license. See LICENSE.txt for details.