在線體驗(yàn)

片刻之歡愉，不如須臾之寧?kù)o。

1.3.1 在線體驗(yàn)

//默認(rèn)的接口服務(wù)
http://demo.phalapi.net/
{
    "ret": 200,
    "data": {
        "title": "Hello World!",
        "content": "PHPer您好，歡迎使用PhalApi！",
        "version": "1.2.0",
        "time": 1443278491
    },
    "msg": ""
}

//帶參數(shù)的示例接口
http://demo.phalapi.net/?service=Default.Index&username=oschina
{
    "ret": 200,
    "data": {
        "title": "Hello World!",
        "content": "oschina您好，歡迎使用PhalApi！",
        "version": "1.2.0",
        "time": 1443278475
    },
    "msg": ""
}

//故意請(qǐng)求一個(gè)非法的服務(wù)
http://demo.phalapi.net/?service=Demo.None
{
    "ret": 400,
    "data": [],
    "msg": "非法請(qǐng)求：服務(wù)Demo.None不存在"
}

1.3.2 在線接口調(diào)試

這里說(shuō)的接口調(diào)試，更多是針對(duì)接口調(diào)用過程中所執(zhí)行的SQL語(yǔ)句查看，如：

//帶&__sql__=1可打印SQL語(yǔ)句
http://demo.phalapi.net/?service=User.getMultiBaseInfo&user_ids=1,2,3&__sql__=1

返回：
[1 - 0.00032s]SELECT * FROM tbl_user WHERE (id = ?); -- 1
[2 - 0.00019s]SELECT * FROM tbl_user WHERE (id = ?); -- 2
[3 - 0.00016s]SELECT * FROM tbl_user WHERE (id = ?); -- 3
{"ret":200,"data":{"code":0,"msg":"","list":[{"id":"1","name":"dogstar","note":"oschina"},{"id":"2","name":"aevit","note":"fami"},{"id":"3","name":"test","note":"phalapi"}]},"msg":""}

1.3.3 [酷！]接口參數(shù)在線查詢

為了方便客戶端查看最新的接口參數(shù)，特別提供此在線工具，根據(jù)接口代碼實(shí)時(shí)生成接口參數(shù)報(bào)表，完全不需要后臺(tái)開發(fā)編寫維護(hù)額外的文檔。我覺得，這很符合敏捷開發(fā)之道。

//接口參數(shù)在線查詢工具鏈接
http://demo.phalapi.net/checkApiParams.php

如：http://demo.phalapi.net/checkApiParams.php ，訪問效果如下：

因此，接口所需要的參數(shù)，對(duì)于接口開發(fā)人員，也只是簡(jiǎn)單配置一下參數(shù)規(guī)則，便可以輕松獲取。
關(guān)于具體的參數(shù)規(guī)則配置和接口結(jié)果返回格式定義，后期會(huì)詳細(xì)講到。