README

BusSystem 是公交运输控制系统

安装

使用 php composer 安装 nikba/bus-system-php-sdk

  composer require nikba/bus-system-php-sdk

用法/示例

$bussystem = new \Nikba\BusSystemPhpSdk\BusSystem(
    'BASE URL', 
    'LOGIN', 
    'PASSWORD', 
    'en'
);

# Get All Countries
$params = ['viev' => 'get_country'];
$points = $bussystem->getPoints($params);

Web 服务功能

• get_points — 选择可用的城市、国家以及动态链接的城市（与过时的 get_country 函数结合，可选函数）

• get_routes — 关于所选城市区间内所有可用的路线信息（根据指定日期）

• get_plan — 公交车内的座位计划（所有路线，可选函数）

• get_free_seats — 搜索座位数量（公交车和火车）以及火车车厢（火车必需）

• get_discount — 路线折扣列表（可选函数）

• get_all_routes — 路线时刻表（可选函数）

• new_order — 根据lock_min（通常为10分钟）期限创建新订单。lock_min到期后，订单将自动取消。某些路线允许在指定时间内锁定座位。此外，某些路线可能在lock_min到期后也可以付费，但这并不保证成功销售和指定的座位（可能会更改）。

• buy_ticket — 根据生成的订单（第3点 new_order）销售票务

• cancel_ticket — 订单取消和票务退款（与过时的 cancel_order 函数结合）

• get_ticket — 获取关于票务的完整信息（可选函数）

• get_order — 获取关于订单的完整信息

• print_ticket — 获取电子票单（根据所选路线，承运人可以有不同的设计）。乘客必须在公交车上出示此单，而不是来自终端、银行等地的收据，否则乘客可能会被拒绝乘车。

• get_orders — 订单列表（如果适用支付）

• get_tickets — 票务列表（如果适用支付）

• get_tickets (dispatcher) — 承运人和调度员的票务列表

• get_cash — 现金（如果适用支付）

在所有上述请求中，建议发送标签 session=xxxx（用户会话）- 这是获取需要此标签的路线的方法。

API 参考

所有数据均应通过 HTTP（真实系统使用 HTTPS）使用 POST 方法传输。查询数据以 XML 格式返回。

测试查询地址：https://test-api.bussystem.eu/server

生产查询地址：https://api.bussystem.eu/server

get_points

  POST /server/curl/get_points.php

get_routes

  POST /server/curl/get_routes.php

get_plan

  POST /server/curl/get_plan.php

get_free_seats

  POST /server/curl/get_free_seats.php

get_discount

  POST /server/curl/get_discount.php

get_all_routes

  POST /server/curl/get_all_routes.php

new_order

  POST /server/curl/new_order.php

buy_ticket

  POST /server/curl/buy_ticket.php

reg_ticket

  POST /server/curl/reg_ticket.php

cancel_ticket

  POST /server/curl/cancel_ticket.php

get_ticket

  POST /server/curl/get_ticket.php

get_order

  POST /server/curl/get_order.php

get_orders

  POST /server/curl/get_orders.php

get_orders (partners)

  POST /server/curl_partner/get_orders.php

get_tickets

  POST /server/curl_partner/get_tickets.php

get_tickets (dispatcher)

  POST /server/curl_dispatcher/get_tickets.php

get_cash

  POST /server/curl/get_cash.php

文档

文档

支持

对于支持，GitHub Issues