restful은 현재 가장 인기 있는 인터페이스 디자인 사양입니다. 프론트엔드와 백엔드 모두가 알아야 할 사양입니다.
이 사양은 인터페이스 개발의 각 프로세스에서
프로토콜을 정의합니다. 클라이언트는 API를 통해 백엔드와 상호 작용합니다. 최종 서비스 통신 과정에서 HTTPS 프로토콜을 사용해야 합니다.
도메인 이름
API는 전용 도메인 이름으로 배포되어야 하며 최대한 단순하게 유지되어야 합니다. API가 매우 간단하고 더 이상 확장되지 않을 것이라고 확신하는 경우 기본 도메인 이름 아래에 배치하는 것을 고려할 수 있습니다. 다음은 두 가지 일반적인 URL 루트 예입니다.
api.example.com/* 별도의 하위 도메인 이름 인터페이스에 액세스하는 데 사용됩니다
모든 API는 이전 버전과 호환되는 동시에 새 버전의 API를 도입해야 합니다. 의 API를 계속 사용할 수 있습니다. 따라서 버전 지원이 제공되어야 합니다
주소(경로) Router
API 특정 URL
URL의 이름은 모두 소문자여야 합니다.
https://api.example.com/zoos
HTTP 동사로 표시되는 특정 작업 유형입니다. 일반적으로 사용되는 5개의 HTTP 동사가 있습니다(해당 SQL 명령은 괄호 안에 있음).
GET(SELECT): 서버에서 하나 이상의 리소스를 가져옵니다.
모든 URL 매개변수는 모두 소문자여야 하며 밑줄 유형 매개변수 형식을 사용해야 합니다.Paging 매개변수는 페이지로 고정되어야 하며, page_size
Response(Response)
적절한 HTTP 상태를 선택해야 합니다. 코드. JSON 형식 데이터를 반환해야 합니다.
모든 오류는 동일한 오류 형식이어야 합니다.
공통 상태 코드
1xx는 요청이 승인되었으며 계속 처리해야 함을 의미합니다.
'message' => ':message', // 错误的具体描述 'errors' => ':errors', // 参数的具体错误描述,422 等状态提供 'code' => ':code', // 业务自定义的异常码 'status_code' => ':status_code', // http状态码 'debug' => ':debug', // debug 信息,非生产环境提供
HTTP 메시지는 HTTP 요청 및 응답 시 정보를 교환하는 데 사용됩니다. 메시지는 클라이언트에서 서버로 전달됩니다. 메시지는 요청 메시지와 응답 메시지의 두 가지 범주로 나누어집니다. 요청 메시지와 응답 메시지의 기본 메시지 구조는 동일하며 다음 세 부분으로 구성됩니다.
시작 라인: 설명 message
Header: 일부 속성
Body: Data [선택 사항]
Promise API 지원 지원 요청 및 응답 차단
요청 데이터 및 응답 데이터 변환 요청 취소
JSON 데이터 자동 변환
클라이언트는 XSRF에 대한 방어를 지원합니다
어서, 낯선 사람들이여! 도움이 됩니다)
위 내용은 프론트엔드와 백엔드 커뮤니케이션에서는 이러한 핵심 지식 포인트를 마스터해야 합니다!의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!