etalab / rncs_worker_api_entreprise

API pour récupérer et mettre à disposition les données du Répertoire National du Commerce et des Société
https://entreprise.data.gouv.fr
MIT License
23 stars 13 forks source link

Renommage de l'endpoint d'accès aux fiches d'identités #100

Closed brindu closed 5 years ago

brindu commented 5 years ago

Je propose un renaming de /infos_identite_entreprise aujourd'hui en /fiches_identite.

Je trouve l'existant un peu long, et comme on release bientôt ce sera l'occasion ici de valider ici le nom de l'endpoint choisi.

C'est pas seulement parce que je trouve l'actuel trop long :

Du coup je propose fiches_identite : c'est francisé, c'est clair et le mot "fiche" sera aussi présent partout sur le site et dans les docs (à cause du mot interdit), et pas besoin du "infos" (c'est REST compliant).

WDYT @giglemad @Haelle ?

Haelle commented 5 years ago

Très bonne idée, j'avais aussi en tête de les renommer pour les mêmes raisons. J'ai pas de proposition de nom et j'aime bien fiche_identite

Édit: du coup c'est mieux singulier ou pluriel ? Je me suis surpris à l'écrire au singulier (pluriel pour du REST? mais on aura rien d'autre que show non ?)

brindu commented 5 years ago

Pour du REST le nom de la ressource dans l'URL est bien au pluriel. Et oui uniquement show comme action, mais ça n'impact pas l'orthographe de la ressource.

hugolepetit commented 5 years ago

Ok pour moi