Maison > Article > interface Web > Ces points de connaissances fondamentaux doivent être maîtrisés dans la communication front-end et back-end !
restful est la spécification de conception d'interface la plus populaire à l'heure actuelle. C'est une spécification que le front-end et le back-end doivent connaître
Cette spécification définit le
protocole dans chaque processus de développement d'interface. le client interagit avec le backend via l'API. Dans le processus de communication de service final, le protocole HTTPS doit être utilisé
Nom de domaine
L'API doit être déployée sous un nom de domaine dédié et doit rester aussi simple que possible. Si vous êtes sûr que l'API est très simple et ne sera pas développée davantage, vous pouvez envisager de la placer sous le nom de domaine principal. Voici deux exemples courants de racine d'URL :
api.example.com/* Un nom de sous-domaine distinct. est utilisé pour accéder à l'interface
Toutes les API doivent rester rétrocompatibles Vous devez introduire les nouvelles versions des API tout en vous assurant que les anciennes versions. des API sont toujours disponibles. Par conséquent, une prise en charge de la version doit être fournie pour cela
Adresse (chemin) du routeur
URL spécifique à l'API
Le nom de l'URL doit être entièrement en minuscules
https://api.example.com/zoos
pour les ressources Types d'opérations spécifiques, représentés par des verbes HTTP. Il existe cinq verbes HTTP couramment utilisés (les commandes SQL correspondantes sont entre parenthèses).
GET (SELECT) : Obtenez une ou plusieurs ressources du serveur.
Tous les paramètres d'URL doivent être en minuscules et doivent utiliser le formulaire de paramètre de type trait de soulignementLes paramètres de pagination doivent être fixés sur page, page_size
Response(Response)
doit choisir le statut HTTP approprié coder. Doit renvoyer les données au format JSON.
Toutes les erreurs doivent être dans le même format d'erreur.
Codes d'état courants
1xx signifie que la demande a été acceptée et doit continuer le traitement. Elle n'apparaît généralement pas dans l'API
'message' => ':message', // 错误的具体描述 'errors' => ':errors', // 参数的具体错误描述,422 等状态提供 'code' => ':code', // 业务自定义的异常码 'status_code' => ':status_code', // http状态码 'debug' => ':debug', // debug 信息,非生产环境提供Qu'est-ce qu'un message ?
Les messages HTTP sont utilisés pour échanger des informations lors de requêtes et de réponses HTTP. Les messages arrivent sur le serveur depuis le client. Les messages sont divisés en deux catégories : les messages de demande et les messages de réponse. Les structures de base des messages de demande et de réponse sont les mêmes et sont composées de trois parties :
starting Ligne de départ : Décrivez le message
En-tête : certains attributs
Corps : données [Facultatif]
Support Promise API Support interception des demandes et des réponses
Convertir les données de demande et les données de réponse Annuler la demande
Convertir automatiquement les données JSON
Le client prend en charge la défense contre XSRF
Allez, étrangers (j'espère que vous n'êtes pas un étranger lorsque vous allez et venez, je ! j'espère utile pour vous)
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!