Quoi utiliser pour l'espace de REPOS, d'URI?

Que dois-je utiliser:

  • /findby/nom de/{premier}_{dernier}
  • /findby/nom de/{premier}-{dernier}
  • /findby/nom de/{premier};{dernier}
  • /findby/nom/prénom/{premier}//{dernier}

etc.

L'URI représente une Personne ressource avec 1 nom, mais j'ai besoin d'logiquement distincte de la première à la dernière pour identifier chaque. J'aime bien le dernier exemple parce que je peux le faire:

  • /findby/nom/prénom/{premier}
  • /findby/prénom//{dernier}
  • /findby/nom/prénom/{premier}//{dernier}

OriginalL'auteur Droo | 2010-04-09

  1. 13

    Vous pouvez toujours juste accepter espaces 🙂 (querystring échappé que 20%)

    Mais ma préférence est de simplement utiliser les tirets (-) ... regarde plus agréable dans l'URL. sauf si vous avez un besoin d'être en mesure de l'essentiel de la requête, auquel cas le dernier exemple est mieux comme vous l'avez remarqué

    OriginalL'auteur Joel Martinez

  2. 12

    Pourquoi ne pas utiliser + pour l'espace?

    Je suis à une perte: tirets, des inconvénients, des traits de soulignement %20... pourquoi ne pas simplement utiliser +? C'est la façon dont les espaces sont codés normalement dans les paramètres de requête. Oui, vous pouvez utiliser %20 trop mais pourquoi, semble laid.

    Je ferais 

    /personNamed/Joe+Blow
    Cela fait mon code heureux. Merci.

    OriginalL'auteur Nas Banov

  3. 2

    J'aime bien les utiliser "_" car il est le plus similaire de caractère à l'espace qui garde l'URL lisible.

    Toutefois, l'Url que vous avez fourni ne semble pas vraiment Reposant. Une URL doit représenter une ressource, mais dans votre cas, il représente une requête de recherche. Donc, je voudrais faire quelque chose comme ceci:

    /people/{first}_{last}
/people/{first}_{last}_(2)  - in case there are duplicate names

    Il ce cas, vous devez stocker le slug ({first}_{last}, {first}_{last}_(2)) pour chaque enregistrement d'utilisateur. Une autre option pour ajouter l'ID, de sorte que vous n'avez pas à s'embêter avec les limaces:

    /people/{id}-{first}_{last}

    Et pour la recherche, vous pouvez utiliser la non-Sommeil Url:

    /people/search?last={last}&first={first}

    Ces permettrait d'afficher une liste de résultats de recherche, tandis que les Url ci-dessus la page pour une personne en particulier.

    Je ne pense pas qu'il soit utile de faire de la recherche Url Reposante, les utilisateurs les plus susceptibles de vouloir partager des liens à une certaine personne de la page et pas les pages de résultats de recherche. Comme pour les moteurs de recherche, d'éviter d'avoir le même contenu pour plusieurs URLs, et vous devriez même refuser l'indexation de vos pages de résultats de recherche dans robots.txt

    Il n'y a pas une telle chose comme une bonne URL. Du contenu ou de la structure d'une URL est opaque pour un séjour Reposant système. Les résultats d'une recherche est une ressource trop.

    OriginalL'auteur Leventix

  4. 2

    Pour la recherche:

    /people/search?first={first}&last={last}
/people/search?first=george&last=washington

    Des ressources chemins:

    /people/{id}-{first}-{last}
/people/35-george-washington

    Si vous êtes en utilisant Ruby on Rails v3 en configuration standard, voici comment vous pouvez le faire.

    # set up the /people/{param} piece
# config/routes.rb
My::Application.routes.draw do
  resources :people
end

# set up that {param} should be {id}-{first}-{last}
# app/models/person.rb
class Person < ActiveRecord::Base
  def to_param
    "#{id}-#{to_slug(first_name)}-#{to_slug(last_name)}"
  end
end

    Note de votre suggestion, /findby/name/first/{first}/last/{last}, n'est pas de tout repos. Il n'a pas les ressources de nom et il n'a pas les nommer de manière succincte.

    Ce qui RESTE de la contrainte n'est que la dernière URL violer?
    Je ne suis pas au courant qu'il y a une liste de contrôle qui définit ce que cela signifie d'être en RESTE.
    Oui il y a des. Le RESTE de style architectural a été défini par l'application d'un ensemble de contraintes à la nulle style. Ici, nordsc.com/ext/classification_of_http_based_apis.html c'est une bonne table pour déterminer si un système est reposante ou pas.

    OriginalL'auteur yfeldblum

  5. 0

    Le plus sophistiqué, le choix devrait toujours et d'abord tenir compte de deux contraintes:

    1. Que vous ne saurez jamais comment des développeurs ou à l'appareil d'être mis en place est en ce qui concerne la manipulation de urlendoding, je vais toujours essayer de me limiter à la table de caractères conseillés, comme dans l'excellent coup de gueule (S'il vous plaît) Cesser d'Utiliser les Caractères déconseillés dans les Url
    2. Aussi - nous voulons considérer le client de consommer de l'API. Pouvons-nous avoir l'ensemble de la structure facilement représentés et accessibles dans le langage de programmation côté client? Quelles sont les particularités des personnages ce requierement nous laisse? I. e. un $ sera bien en javascript, les noms de variables et donc directement accessible dans le résultat de l'analyse, mais un client PHP va encore avoir à utiliser de plus en plus complexe (et potentiellement plus déroutant) de notation $userResult->{'$mostVisited'}->someProperty... un coup de feu dans votre propre pied! Donc, pour ces deux (et un couple de d'autres environnements de programmation) soulignent semble que la seule option valable.

    Sinon je plutôt d'accord avec @yfeldblum réponse - j'avais distinctes entre un point de terminaison de recherche contre le réel unique de recherche de ressources. Se sent de plus de REPOS pour moi, mais plus important encore, les deux ont un importante différence de coût sur votre serveur d'api - de cette façon, vous pouvez facilement et distinct, c'est à dire payer plus les coûts ou les taux de restreindre la recherche d'un point d'extrémité doit jamais vous en avez besoin.

    À être Pragmatique, par opposition à un "RESTafarian" mentionnés approche /people/35-george-washington pourrait (et devrait à mon humble avis) en fait, répondre à l'id, donc si vous voulez un nom, urlsafe-pour-nuls-lien de la liste de référence, comme /people/35_george_washington. D'autres idées pourraient être /people/35/#GeorgeWashington (brisant ainsi des tonnes de Rfc) ou /people/35_GeorgeWashington - l'API ne serait pas de soins.

    OriginalL'auteur Philzen