悟空电商

Gitter

悟空电商是一个支持多店铺的开源电商软件,由开源社区驱动,基于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.