Questions marquées «api-design»

J'ai eu une discussion animée aujourd'hui au sujet de notre application MVC. Nous avons un site Web écrit en MVC ( ASP.NET ), et il suit généralement le modèle de faire quelque chose dans la vue -> appuyer sur le contrôleur -> le contrôleur construit un modèle (appelle un gestionnaire qui...

J'essaie de comprendre ce que la couche anti-corruption signifie vraiment. Je sais que c'est un moyen de faire la transition / de contourner le code hérité ou de mauvaises API. Ce que je ne comprends pas, c'est comment cela fonctionne et ce qui en fait une séparation nette de la couche indésirable....

Lors de la conception d'une interface RESTful, la sémantique des types de demandes est considérée comme essentielle à la conception. GET - Lister une collection ou récupérer un élément PUT - Remplace la collection ou l'élément POST - Créer une collection ou un élément DELETE - Eh bien, erm, delete...

Disons que j'ai une entité qui a l'attribut "type". Il pourrait y avoir plus de 20 types possibles. Maintenant, on me demande d'implémenter quelque chose qui permettrait de changer le type de A-> B, qui est le seul cas d'utilisation. Devrais-je donc implémenter quelque chose qui permet des...

Dites que j'ai un point de terminaison REST qui prend un entier en tant que paramètre: /makeWaffles?numberOfWaffles=3 Dans ce cas, je veux que le nombre soit positif car je ne peux pas créer un nombre négatif de gaufres (et demander 0 gaufres est une perte de temps). Je souhaite donc rejeter toute...

Notre service est présent dans 5 villes. Si quelqu'un essaie d'appeler notre API de service depuis une autre ville, nous voulons lancer cette erreur Service not available in your area. La question est, quel est le code http approprié serait pour cette erreur? 503 Service Indisponible 403: interdit...

Disons que vous codez une fonction qui prend l’entrée d’une API externe MyAPI. Cette API externe MyAPIa un contrat qui stipule qu’elle renverra un stringou number. Est - il recommandé de se prémunir contre des choses comme null, undefined, boolean, etc. , même si elle ne fait pas partie de l'API...

Je suis en train de coder une API pour un réseau social avec le Slim Framework. Ma question est la suivante: quelles sont les meilleures pratiques lorsqu'il n'y a aucune ligne à renvoyer dans la structure json? Disons que cet appel / v1 / get / movies renvoie 2 lignes à partir des noms de film de...

Je travaille actuellement sur un projet avec une organisation comme suit: Client - Obtient des données du serveur principal via l'API REST. Serveur - Demande des données à différents serveurs via des API tierces API tierces - Services hors de mon contrôle qui fournissent des données au serveur...

Je me demandais à ce sujet. Supposons que j'ai une userressource avec idet des namechamps. Si je veux mettre à jour un champ, je pourrais simplement faire une requête PATCH à la ressource comme ceci PATCH /users/42 {"name": "john doe"} Et puis l'application mettra à jour le nom d'utilisateur 42....

J'écris une implémentation Java d'un jeu de cartes, alors j'ai créé un type spécial de Collection que j'appelle une Zone. Toutes les méthodes de modification de la collection Java ne sont pas prises en charge, mais il existe une méthode dans l'API de zone move(Zone, Card), qui déplace une carte de...

J'entends toujours des gens (Crockford en particulier) dire que le DOM est une API terrible, mais ne justifie pas vraiment cette déclaration. Outre les incohérences entre les navigateurs, quelles sont les raisons pour lesquelles le DOM est considéré comme si

Je me demande pourquoi java.util.ArrayListpermet d'ajouter null. Y a-t-il un cas où je voudrais ajouter nullà un ArrayList? Je pose cette question parce que dans un projet, nous avions un bogue qui ajoutait du code nullà la ArrayListet il était difficile de localiser la bogue. De toute évidence, un...

Dites dans mon application, certains utilisateurs nous donnent leur nom de famille, d'autres non. Dans une réponse de l'API REST, quel corps est préféré: Avec une valeur "null": {"firstName": "Bob", "lastName": null} Ou juste une clé manquante: {"firstName": "Bob"}

Je travaille avec une API REST qui réside sur un serveur qui gère les données pour une multitude de périphériques IoT. Ma tâche consiste à interroger le serveur à l'aide de l'API pour collecter des informations de performances spécifiques concernant ces périphériques. Dans un cas, j'obtiens une...

En ce qui concerne les API JSON, est-il recommandé d’aplanir les réponses et d’éviter les objets JSON imbriqués? Par exemple, disons que nous avons une API similaire à IMDb mais pour les jeux vidéo. Il existe plusieurs entités, Game, Platform, ESRBRating et GamePlatformMap, qui mappent les jeux et...

Nous avons une fonction API qui décompose un montant total en montants mensuels en fonction de dates de début et de fin données. // JavaScript function convertToMonths(timePeriod) { // ... returns the given time period converted to months } function getPaymentBreakdown(total, startDate, endDate) {...

Je propose des modifications à un projet de logiciel très mal architecturé qui souffre d'une multitude de problèmes. À un niveau élevé, le projet utilise Angular sur le système frontal et utilise diverses API REST. ce qui est génial (je ne vois pas la nécessité de changer notre technologie ou nos...

Existe-t-il une sorte de norme concernant les réponses de l'API HTTP? Après avoir lu ce fil de discussion, j'ai commencé à me poser des questions. Nous développons notre API JSON HTTP publique sur mon travail, et nous ne renvoyons rien si ce n’est pas strictement nécessaire (par exemple, un PUT...

Dans une discussion sur les méthodes statiques et d'instance, je pense toujours que cela Sqrt()devrait être une méthode d'instance de types numériques au lieu d'une méthode statique. Pourquoi donc? Cela fonctionne évidemment sur une valeur. // looks wrong to me var y = Math.Sqrt(x); // looks better...