❶ 什麼是介面文檔,如何寫介面,有什麼規范
介面文檔一般是提供給商戶對接時進行參考及提供幫助的一個說明文檔或API。裡麵包含借口說明、介面列表、介面參數列表、簽名/驗簽規則、商戶應答規則等說明;
介面一般要首先考慮安全性,支付類的簽名可以參考支付寶和微信支付這一類的介面文檔,業務類的簽名可以參考微信公眾平台的介面API;
加簽是根據商戶號、業務參數、隨機字元串或時間戳、商戶密鑰/公鑰私鑰等按照規則組裝參數,然後按照一個簽名規則生成簽名,以保證介面的安全性;
❷ 介面文檔包含的主要內容有哪些
一個規范的介面文檔,要包含以下信息:
1)基本信息(介面名稱、請求方法、請求路徑、介面描述)
2)請求參數(請求頭、請求體)
3)返回數據(不同情況的響應狀態碼、響應數據)
如果想系統的學習介面測試相關的技術,可以了解一下黑馬程序員的軟體測試課程,裡面講的非常詳細。
❸ 前後端數據交互前後端數據交互數據都有哪些類型
一般後端介面提供JSON格式的數據類型與前端交互
也可以使用XML格式的數據類型,前者使用頻率更高
❹ 規范的介面文檔中,都包含那些信息
一般一個規范的介面文檔至少包含三部分信息,分別是基本信息,請求參數部分,響應部分
基本部分又包括介面名稱,介面URL,請求方法以及描述信息;
請求參數部分主要包括請求頭和請求體部分,主要是對這兩個部分的每個欄位定義的說明和解釋
響應部分主要包括響應返回的數據類型,已經響應數據中每個欄位的含義  。
以前在黑馬程序員培訓後,也會買他們出版的書,這個就是直接從書上看的。現在很多大學都用的他們的教材,我就會沒事看看。反正說的挺詳細的。
❺ 前後端分離,關於介面文檔,後端是要先寫好介面文檔,再進行寫代碼開發,還是寫完代碼後再編寫介面文檔
1、先理清業務流程
2、定義前後端開發的介面規范。比如json的格式,url的格式
3、定義介面文檔,這里的介面文檔一般就是對應後台的實體reqVo(調用後台介面<控制器>訪問的實體)和返回給前台的respVo(前台調用介面的返回的實體)。注意一般respVo都會有在後台做一個統一的處理為ResultVo(這個規范在2中要定義好,比如:錯誤碼,錯誤描述,請求的url,請求時間,以及實體T<這個實體才是真正的respVo和業務相關,這個一般都是實體>)
4、定義介面文檔是在了解業務流、數據流基礎之上完成的。有了這個介面文檔(其實就是定義實體的過程和對應的json)前後端的開發基本按照這個文檔去開發。介面文檔會有版本迭代,一般放到svn上,供所有開發人員閱覽
5、現在一般系統用到的資料庫都不會是單純mysql了。還有redis,mongo、es等。這些個人感覺都是在十分了解業務的情況和系統架構下去設計的。後台運用這些工具去完成介面功能的實現已經系統功能和性能的實現。這個和介面文檔先後順序還真不好說,個人覺得都可以。
6、業務流-數據流-資金流。去了解和設計系統。
❻ 前端 介面 文檔介面 是什麼意思
就是ajax請求用的地此,介面文檔包含地此,值格式,請求的參數等等。。。。
❼ 什麼是介面文檔,如何寫介面,有什麼規范
含義是:在項目開發中,web項目的前後端分離開發,APP開發,需要由前後端工程師共同定義介面,編寫介面文檔,之後大家都根據這個介面文檔進行開發,到項目結束前都要一直維護。
目的是:項目開發過程中前後端工程師有一個統一的文件進行溝通交流開發。項目維護中或者項目人員更迭,方便後期人員查看、維護。
規范是:以/a開頭,如果需要登錄才能調用的介面(如新增、修改;前台的用戶個人信息,資金信息等)後面需要加/u,即:/a/u;中間一般放表名或者能表達這個介面的單詞;get方法,如果是後台通過搜索查詢列表,那麼以/search結尾,如果是前台的查詢列表,以/list結尾;url參數就不說了。

API(Application Programming Interface,應用程序介面)是一些預先定義的介面(如函數、HTTP介面),或指軟體系統不同組成部分銜接的約定。用來提供應用程序與開發人員基於某軟體或硬體得以訪問的一組常式,而又無需訪問源碼,或理解內部工作機制的細節。
應用程序介面又稱為應用編程介面,是一組定義、程序及協議的集合,通過 API介面實現計算機軟體之間的相互通信。API 的一個主要功能是提供通用功能集。
API同時也是一種中間件,為各種不同平台提供數據共享。程序設計的實踐中,編程介面的設計首先要使軟體系統的職責得到合理劃分。良好的介面設計可以降低系統各部分的相互依賴,提高組成單元的內聚性,降低組成單元間的耦合程度,從而提高系統的可維護性和可擴展性。
❽ 文檔的類型有哪些
文檔格式有很多,但常用的不多,有doc x——word文檔,elsx——excel 文檔,pdf,   text記事本文檔  ,html  網頁文檔,pptx幻燈片文檔~~~~~~~~~~~~~等,希望對你有用~~
~
A 
ACE:Ace壓縮檔案格式 
ACT:Microsoft office助手文件 
AIF,AIFF:音頻互交換文件,Silicon Graphic and Macintosh應用程序的聲音格式 
ANI:Windows系統中的動畫游標 
ARC:LH ARC的壓縮檔案文件 
ARJ:Robert Jung ARJ壓縮包文件 
ASD:Microsoft Word的自動保存文件;Microsoft高級流媒體格式(microsoft advanced streaming 
format,ASF)的描述文件;可用NSREX打開 Velvet Studio例子文件 
ASF:Microsoft高級流媒體格式文件 
ASM:匯編語言源文件,Pro/E裝配文件 
ASP:動態網頁文件;ProComm Plus安裝與連接腳本文件;Astound介紹文件 
AST:Astound多媒體文件;ClarisWorks「助手」文件 
Axx:ARJ壓縮文件的分包序號文件,用於將一個大文件壓至幾個小的壓縮包中(xx取01-99的數字) 
A3L:Authorware 3.x庫文件 
A4L:Authorware 4.x庫文件 
A5L:Authorware 5.x庫文件 
A3M,A4M:Authorware Macintosh未打包文件 
A3W,A4W,A5W:未打包的Authorware Windows文件 
B 
BAK:備份文件 
BAS:BASIC源文件 
BAT:批處理文件 
BIN:二進制文件 
BINHex:蘋果的一種編碼格式 
BMP:Windows或OS/2點陣圖文件 
BOOK:Adobe FrameMaker Book文件 
BOX:Lotus Notes的郵箱文件 
BPL:Borlard Delph 4打包庫 
BSP:Quake圖形文件 
BUN:CakeWalk 聲音捆綁文件(一種MIDI程序) 
C 
C0l:台風波形文件 
CAB:Microsoft壓縮檔案文件 
CAD:Softdek的Drafix CAD文件 
CAM:Casio照相機格式 
CAP:壓縮音樂文件格式 
CAS:逗號分開的ASCⅡ文件 
CCB:Visual Basic動態按鈕配置文件 
CCH:Corel圖表文件 
CCO:CyberChat數據文件 
CCT:Macromedia Director Shockwave投影 
CDA:CD音頻軌道 
CDF:Microsoft頻道定義格式文件 
CDI:Philip的高密盤交互格式 
CDM:Visual dBASE自定義數據模塊文件 
CDR:CorelDRAW繪圖文件;原始音頻CD數據文件 
CDT:CorelDRAW模板 
CDX:CorelDRAW壓縮繪圖文件;Microsoft Visual FoxPro索引文件 
CFG:配置文件 
CGI:公共網關介面腳本文件 
CGM:計算機圖形元文件 
CH:OS/2配置文件 
CHK:由Windows磁碟碎片整理器或磁碟掃描保存的文件碎片 
CHM:編譯過的HTML文件 
CHP:Ventura Publisher章節文件 
CHR:字元集(字體文件) 
CHT:ChartViem文件;Harvard Graphics矢量文件 
CIF:Adaptec CD 創建器 CD映像文件 
CIL:Clip Gallery下載包 
CIM:SimCity 2000文件 
CIN:OS/2改變控制文件用於跟蹤INI文件中的變化 
CLASS:Java類文件 
CLP:Windows 剪貼板文件 
CLL:Crick Software Clicker文件 
CLS:Visual Basic類文件 
CMD:Windows NT,OS/2的命令文件;DOS CD/M命令文件;dBASEⅡ程序文件 
CPI:Microsoft MS-DOS代碼頁信息文件 
CPL:控制面板擴展名,Corel顏色板 
CPP:C++代碼文件 
CPR:Corel提供說明書文件 
CPT:Corel 照片-繪畫圖像 
CST:Macromedia Director Cast文件 
CUR:Windows游標文件 
D 
DBF:dBASE文件,一種由Ashton-Tate創建的格式,可以被ACT!、Lipper、FoxPro、Arago、Wordtech、Xbase和類似資料庫或與資料庫有關產品識別;可用數據文件(能被Excel 
97打開);Oracle 8.1.x表格空間文件 
DBX:DataBearn圖像;Microsoft Visual FoxPro表格文件 
DCT:Microsoft Visual FoxPro資料庫容器 
DCU:Delphi編譯單元文件 
DCX:Microsoft Visual FoxPro資料庫容器;基於PCX的傳真圖像;宏 
DIR:MacromediaDirector文件 
DLL:動態鏈接庫 
DOC:FrameMaker或FrameBuilder文檔;Word Star文檔、Word 
Perfect文檔、Microsoft:Word文檔;DisplayWrite文檔 
DOT:Microsoft Word文檔模板 
DPL:Borland Delph 3壓縮庫 
DRV:驅動程序 
DRW:Micrografx Designer/Draw;Pro/E繪畫文件 
DSF:Micrografx Designer VFX文件 
DSG:DOOM保存的文件 
DSM:Dynamic Studio音樂模塊(MOD)文件 
DSP:Microsoft Developer Studio工程文件 
DSQ:Corel QUERY(查詢)文件 
DST:刺綉機圖形文件 
DSW:Microsoft Developer Studio工作區文件 
DTA:World Bank(世界銀行)的STARS數據文件 
DTD:SGML文檔類型定義(DTD)文件 
DTED:地面高度數字數據(圖形的數據格式)文件 
DTF:Symantec Q&A相關的資料庫數據文件 
DTM:DigiTrakker模塊文件 
DUN:Microsoft拔號網路導出文件 
DV:數字視頻文件(MIME) 
DWG:AutoCAD工程圖文件;AutoCAD或Generic CADD老版本的繪圖格式 
DXR:Macromedia Director受保護(不可編輯)電影文件 
E 
EDA:Ensoniq ASR磁碟映像 
EDD:元素定義文檔(FrameMaker+SGML文檔) 
EDE:Ensoniq EPS磁碟映像 
EDK:Ensoniq KT磁碟映像 
EDQ:Ensoniq SQ1/SQ2/Ks32磁碟映像 
EDS:Ensoniq SQ80磁碟映像 
EDV:Ensoniq VFX-SD磁碟映像 
EFA:Ensoniq ASR文件 
EFE:Ensoniq EPS文件 
EFK:Ensoniq KT文件 
EFQ:Ensoniq SQ1/SQ2/Ks32文件 
EFS:Ensoniq SQ80文件 
EFV:Ensoniq VFX-SD文件 
EMD:ABT擴展模塊 
EMF:Windows增強元文件 
EML:Microsoft Outlook Express郵件消息(MIME RTC822)文件 
EXE:可執行文件(程序) 
F 
FAV:Microsoft Outlook導航條 
FAX:傳真類型圖像 
FCD:虛擬CD-ROM 
FDF:Adobe Acrobat表單文檔文件 
FLA:Macromedia Flash電影 
FND:Microsoft Explorer保存的搜索文件(Find applet) 
FON:系統字體 
FRT:Microsoft FoxPro報表文件 
FRX:Visual Basic表單文本;Microsoft FoxPro報表文件 
FXP:經Microsoft FoxPro編譯的源文件 
G 
GDM:鈴聲、口哨聲和聲音板模塊格式 
GetRight:GetRight未完成的下載文件 
GHO:Norton 克隆磁碟映像 
GID:Windows 95全局索引文件(包括幫助狀態) 
GIF:CompuServe點陣圖文件 
GL:動畫格式 
GRP:程序管理組 
H 
HEX:Macintosh BinHex2.0文件 
HLP:幫助文件;Date CAD Windows幫助文件 
HPP:C++程序頭文件 
HQX:Macintosh BinHex 4.0文件 
HT:HyperTerminal(超級終端) 
HTM,HTML:超文本文檔 
HTT:Microsoft超文本模板 
HTX:擴展HTML模板 
I 
ICO:Windows圖標 
IDX:Microsoft FoxPro相關資料庫索引文件;Symantec Q&A相關資料庫索引文件;Microsoft Outlook 
Express文件 
IMG:GEM映像 
INF:信息文件 
INI:初始化文件;Mwave DSP Synth的「nwsynth.ini」 GMS安裝;Cravis Ultrasound bank安裝 
INP:Oracle 3.0版或早期版本的表單源代碼 
INRS:INRS遠程通信聲頻 
INS:InstallShield安裝腳本;X-Internet簽字文件;Ensoniq EPS字簇設備;Cell/ⅡMAC/PC抽樣設備 
INT:中間代碼,當一個源程序經過語法檢查後編譯產生一個可執行代碼 
IOF:Findit文檔 
IQY:Microsoft Internet查詢文件 
ISO:根據ISD 9660有關CD-ROM文件系統標准列出CD-ROM上的文件 
ISP:X-Internet簽字文件 
IST:數字跟蹤設備文件 
ISU:InstallShield卸裝腳本 
IT:脈沖跟蹤系統音樂模塊(MOD)文件 
ITI:脈沖跟蹤系統設備 
ITS:脈沖跟蹤系統抽樣,Internet文檔位置 
IV:Open Inventor中使用的文件格式 
IVD:超過20/20微觀數據維數或變數等級文件 
IVP:超過20/20的用戶子集配置文件 
IVT:超過20/20表或集合數據文件 
IVX:超過20/20微數據目錄文件 
IW:Idlewild屏幕保護程序 
IWC:Install Watch文檔 
J 
J62:Ricoh照相機格式 
JAR:Java檔案文件(一種用於applet和相關文件的壓縮文件) 
JAVA:Java源文件 
JAR:Java檔案文件(一種用於applet和相關文件的壓縮文件) 
JAVA:Java源文件 
JFF,JFIF,JIF:JPEG文件 
JPE,JPEG,JPG:JPEG圖形文件 
JS:JavaScript源文件 
JSP:HTML網頁,其中包含有對一個Java servlet的參考 
K 
KAR:卡拉OK MIDI文件(文本+MIDI) 
L 
LAB:Visual dBASE標簽文件 
LBT,LBX:Microsoft FoxPro標簽文件 
LDB:Microsoft Access加鎖文件 
LHA:LZH更換文件後綴 
LOG:日誌文件 
LZH:LH ARC壓縮檔案 
M 
M1V:MPEG相關文件(MIME"mpeg"類型) 
M3D:Corel Motion 3D動畫文件 
M3U:MPEG URL(MIME聲音文件) 
MAM:Microsoft Access宏 
MAQ:Microsoft Access查詢文件 
MAR:Microsoft Access報表文件 
MBX:Microsoft Outlook保存email格式;Eudora郵箱 
MCW:Microsoft Word的Macintosh文檔 
MDB:Microsoft Access資料庫 
MDN:Microsoft Access空資料庫模板 
MDW:Microsoft Access工作組文件 
MID:MIDI音樂 
MMM:Microsoft多媒體電影 
MOV:QuickTime for Windows電影 
MP2:第二層MPEG音頻文件 
MP3:第三層MPEG音頻文件 
MPA:MPEG相關文件,MIME「mpeg類型」 
MPE,MPEG,MPG:MPEG動畫文件 
MPP:Microsoft工程文件;CAD繪圖文件格式 
MPR:Microsoft FoxPro菜單(已編譯) 
MSI:Windows 安裝器包 
MSN:Microsoft 網路文檔;Descent Mission文件 
O 
OBD:Microsoft Office活頁夾 
OBJ:對象文件 
OBZ:Microsoft Office活頁夾向導 
OCX:Microsoft對象鏈接與嵌入定製控制項 
ODS:Microsoft Outlook Express郵箱文件 
OFT:Microsoft Outlook模板 
OPX:OPL擴展DLL(動態鏈接庫) 
OSS:Microsoft Office查找文件 
OST:Microsoft Exchange / Outlook 離線文件 
P 
PAL:壓縮文件 
PART:Go!Zilla部分下載文件 
PAS:Pascal源代碼 
PCS:PICS動畫文件 
PDF:Adobe Acrobat 
可導出文檔格式文件(可用Web瀏覽器顯示);Microsoft系統管理伺服器包定義文件;NetWare列印機定義文件 
PHP,PHP3:包含有PHP腳本的HTML網頁 
PHTML:包含有PHP腳本的HTML網頁;由Perl分析解釋的HTML 
PM5:Pagemaker 5.0文件 
PM6:Pagemaker 6.0文件 
PPS:Microsoft Powerpoint幻燈片放映 
PPT:Microsoft Powerpoint演示文稿 
PRF:Windows系統文件,Macromedia導演設置文件 
PSD:Adobe photoshop點陣圖文件 
PSM:Protracker Studio模型格式;Epic游戲的源數據文件 
PST:Microsoft Outlook個人文件夾文件 
PWL:Windows 95口令列表文件 
Q 
QIF:QuickTime相關圖像(MIME);Quicken導入文件 
QT,QTM:QuickTime電影 
QTI,QTIF:QuickTime相關圖像 
QTP:QuickTime優先文件 
QTS:Mac PICT圖像文件;QuickTime相關圖像 
QTX:QuickTime相關圖像 
R 
RA:RealAudio聲音文件 
RAM:RealAudio元文件 
RAR:RAR壓縮檔案(Eugene Roshall格式) 
REC:錄音機宏;RapidComm聲音文件 
REG:注冊表文件 
REP:Visual dBASE報表文件 
RES:Microsoft Visual C++資源文件 
RM:RealAudio視頻文件 
RMF:Rich Map格式(3D游戲編輯器使用它來保存圖) 
ROM:基於盒式磁帶的家庭游戲模擬器文件(來自Atari 
2600、Colecovision、Sega、Nintendo等盒式磁帶里的ROM完全拷貝,在兩個模擬器之間不可互修改) 
Rxx:多卷檔案上的RAR壓縮文件(xx=1~99間的一個數字) 
S 
SAV:游戲保存文件 
SB:原始帶符號位元組(8位)數據 
SBK:Creative Labs的Soundfont 1.0 Bank文件;(Soundb laster)/EMU SonndFont v1.x 
Bank文件 
SBL:Shockwave Flash對象文件 
SCF:Windows Explorer命令文件 
SCH:Microsoft Schele+1 
SCP:撥號網路腳本文件 
SCR:Windows屏幕保護;傳真圖像;腳本文件 
SFX:RAR自解壓檔案 
SHTML:含有伺服器端包括(SSI)的HTML文件 
SPL:Shockwave Flash對象;DigiTrakker抽樣 
SQL:Informix SQL查詢;通常被資料庫產品用於SQL查詢(腳本、文本、二進制)的文件擴展名 
STM:.shtml的短後綴形式,含有一個服務端包括(SSI)的HTML文件;Scream Tracker V2音樂模塊(MOD)文件 
STR:屏幕保護文件 
SWA:在Macromedia導演文件(MP3文件)中的Shockwave聲音文件 
SWF:Shockwave Flash對象 
SYS:系統文件 
T 
T64:Commodore 64模擬器磁帶映像文件 
THEME:Windows 95桌面主題文件 
TIF,TIFF:標簽圖像文件格式(TIFF)點陣圖 
TMP:Windows臨時文件 
TRM:終端文件 
TXT:ASCⅡ文本格式的聲音數據 
TZ:老的壓縮格式文件 
V 
VBA:VBase文件 
VBP:Microsoft Visual Basic工程文件 
VBW:Microsoft Visual Basic工作區文件 
VBX:Microsoft Visual Basic用戶定製控制項 
VQE,VQL:Yamaha Sound-VQ定位器文件 
VQF:Yamaha Sound-VQ文件(可能出現標准) 
VRF:Oracle 7配置文件 
VSL:下載列表文件(GetRight) 
W 
WAB:Microsoft Outlook文件 
WAD:包含有視頻、玩家水平和其他信息的DOOM游戲的大文件 
WAL:Quake 2正文文件 
WAV:Windows波形聲形 
WBK:Microsoft Word備份文件 
WFM:Visual dBASE Windows表單 
WFN:在CorelDRAW中使用的符號 
WIZ:Microsoft Word向導 
WRL:虛擬現實模型 
WWL:Microsoft Word內插器文件 
X 
XLK:Microsoft Excel備份 
XLL:Microsoft Excel內插器文件 
XLM:Microsoft Excel宏 
XLS:Microsoft Excel工作單 
XLT:Microsoft Excel模板 
XLV:Microsoft Excel VBA模塊 
XLW:Microsoft Excel工作簿/工作區 
Z 
ZAP:Windows軟體安裝配置文件 
ZIP:Zip文件
