Génie logiciel api

5

Quand une API est-elle considérée comme une DSL intégrée?

Quelle est la différence entre une API et un langage DSL (Domain Specific Language) intégré? Est-ce juste de la syntaxe? Considérez une API comme OpenGL. En quoi est-ce différent d'un DSL graphique? En d'autres termes, si une API est suffisamment complexe, peut-elle être considérée comme une DSL intégrée?

10 api dsl

3

Est-ce une mauvaise pratique qu'une définition d'objet API contienne des ID de référence tiers en tant que propriétés?

Comme ça: Campaign: type: object properties: id: type: string description: "A GUID identifier" referenceId: type: string description: "A consumers identifier they have used to map their own systems logic to this object." name: type: string description: "'Great Campaign 2017' as an example" Je suis préoccupé par le referenceId . Le …

9 rest api domain-driven-design api-design single-responsibility

2

Ajout à un ensemble fini d'options; un changement de rupture API?

Prenez un point de terminaison API HTTP qui crache le modèle de réponse suivant: { "type": "Dog", "name": "Jessi", ... } Le typechamp a été décrit dans la documentation comme étant l'un des Dog, Catou Fish. L'ajout d'une nouvelle option, par exemple Rat, serait-il considéré comme une rupture de l'API? …

9 rest api api-design json

3

Dans le langage REST, quelle est la différence entre une ressource et une représentation?

Ma compréhension de REST qui permet de modéliser les opérations de service comme représentation de l'état et transition d'un état à un autre en utilisant HTTP. J'ai toujours compris les ressources comme des représentations de l'état du service jusqu'à récemment lorsque j'ai lu cet article de Jimmy Bogard que je …

9 rest api api-design

2

Avertissements dans une API REST en tant qu'erreurs non critiques

J'ai une API REST qui, pour certaines ententes comme DELETE, POST ou PUT, j'ai des règles de validation qui peuvent renvoyer une erreur. Maintenant, j'ai besoin d'un nouveau type d'erreur comme une erreur non critique, qui devrait échouer de manière normale, mais devrait passer à l'action s'il y a un …

9 rest api

3

API CRUD: Comment spécifiez-vous les champs à mettre à jour?

Disons que vous avez une sorte de structure de données, qui est persistante dans une sorte de base de données. Pour simplifier, appelons cette structure de données Person. Vous êtes maintenant chargé de concevoir une API CRUD, qui permet à d'autres applications de créer, lire, mettre à jour et supprimer …

9 design api web-services api-design crud

3

utilise un PUT avec des effets secondaires acceptables (REST)

Je veux créer un historique d'annulation chaque fois que l'utilisateur met à jour un formulaire. Parce que c'est une mise à jour, je veux utiliser une demande PUT. Cependant, j'ai lu que PUT ne devait avoir aucun effet secondaire . Est-il acceptable d'utiliser PUT ici? Existe-t-il de meilleures alternatives? PUT …

9 language-agnostic api rest

Questions marquées «api»