22.インタフェースドキュメントの作成方法
3683 ワード
ログイン
インタフェースの説明
ユーザーログインインタフェース
インタフェースアドレス
インタフェースアドレス
localhost:8000/login
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
username
ユーザー名
String
はい
password
パスワード
String
はい
戻り値
ブログの作成
インタフェースの説明
ブログインタフェースの作成
インタフェースアドレス
インタフェースアドレス
localhost:8000/add_article
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
最大長さ制限
id
ブログID
Int
いいえ
title
ブログタイトル
String
はい
10
author
ブログの作者
String
はい
10
content
ブログの内容
String
はい
500
戻り値
ブログの変更
インタフェースの説明
ユーザーがブログインタフェースを変更する
インタフェースアドレス
インタフェースアドレス
localhost:8000/modify_article
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
最大長さ制限
id
ブログID
Int
はい
title
ブログタイトル
String
はい
10
author
ブログの作者
String
はい
10
content
ブログの内容
String
はい
500
戻り値
ブログの検索
インタフェースの説明
ユーザーがタイトルに基づいてブログインタフェースを問い合わせる
インタフェースアドレス
インタフェースアドレス
localhost:8000/get_article
リクエストモード
GET
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
title
ブログタイトル
String
いいえ
戻り値
ブログの削除
インタフェースの説明
ブログインタフェースの削除
インタフェースアドレス
インタフェースアドレス
localhost:8000/delete_article
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
id
ブログID
Int
はい
戻り値
前にも述べたように、インタフェースをテストするとき、一般的には添削とログインがこの5種類なので、ここでは簡単にdemoを書いて、以上の5種類をカバーしています.
転載先:https://www.cnblogs.com/suim1218/p/11010378.html
インタフェースの説明
ユーザーログインインタフェース
インタフェースアドレス
インタフェースアドレス
localhost:8000/login
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
username
ユーザー名
String
はい
password
パスワード
String
はい
戻り値
{'status': 1, 'message': 'login success'}
{'status': 0, 'message': 'username or password null'}
{'status': 0, 'message': 'username or password error'}
{'status': 0, 'message': 'request type error'}
ブログの作成
インタフェースの説明
ブログインタフェースの作成
インタフェースアドレス
インタフェースアドレス
localhost:8000/add_article
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
最大長さ制限
id
ブログID
Int
いいえ
title
ブログタイトル
String
はい
10
author
ブログの作者
String
はい
10
content
ブログの内容
String
はい
500
戻り値
{'status': 0, 'message': 'id or title or author or content null'}
{'status': 0, 'message': " "}
{'status': 0, 'message': 'article id already exists'}
{'status': 0, 'message': " "}
{'status': 1, 'data': data, 'message': 'add article success'}
{'status': 0, 'message': 'request type error'}
ブログの変更
インタフェースの説明
ユーザーがブログインタフェースを変更する
インタフェースアドレス
インタフェースアドレス
localhost:8000/modify_article
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
最大長さ制限
id
ブログID
Int
はい
title
ブログタイトル
String
はい
10
author
ブログの作者
String
はい
10
content
ブログの内容
String
はい
500
戻り値
{'status': 0, 'message': 'id or title or author or content null'}
{'status': 0, 'message': " "}
{'status': 0, 'message': 'article not exist'}
{'status': 0, 'message': " "}
{'status': 1, 'data': data, 'message': 'modify article success'}
{'status': 0, 'message': 'request type error'}
ブログの検索
インタフェースの説明
ユーザーがタイトルに基づいてブログインタフェースを問い合わせる
インタフェースアドレス
インタフェースアドレス
localhost:8000/get_article
リクエストモード
GET
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
title
ブログタイトル
String
いいえ
戻り値
{'status': 1, 'message': 'login success'}
{'status': 0, 'message': 'username or password null'}
{'status': 0, 'message': 'username or password error'}
{'status': 0, 'message': 'request type error'}
ブログの削除
インタフェースの説明
ブログインタフェースの削除
インタフェースアドレス
インタフェースアドレス
localhost:8000/delete_article
リクエストモード
POST
要求パラメータ
パラメータ名
説明
パラメータタイプ
必須かどうか
id
ブログID
Int
はい
戻り値
{'status': 0, 'message': 'id null'}
{'status': 0, 'message': " "}
{'status': 0, 'message': 'id not exist'}
{'status': 0, 'message': ' '}
{'status': 1, 'message': 'delete article success'}
{'status': 0, 'message': 'request type error'}
前にも述べたように、インタフェースをテストするとき、一般的には添削とログインがこの5種類なので、ここでは簡単にdemoを書いて、以上の5種類をカバーしています.
転載先:https://www.cnblogs.com/suim1218/p/11010378.html