Users

Comptes utilisateurs avec adresse et entreprise.

10 entrées initiales

Tester

Réponse

…

Champs

Champ	Type	POST et PUT	Règle
`id`	integer	Généré	Généré par l'API
`name`	string	Obligatoire	255 caractères au maximum
`username`	string	Facultatif	255 caractères au maximum
`email`	string	Facultatif	Format email valide
`address`	object	Facultatif	street, suite, city, zipcode, geo { lat, lng }
`phone`	string	Facultatif	255 caractères au maximum
`website`	string	Facultatif	255 caractères au maximum
`company`	object	Facultatif	name, catchPhrase, bs

PATCH ne valide que les champs envoyés. Les données initiales ne sont jamais modifiées : la réponse montre seulement le résultat simulé. DELETE répond toujours 204 sans rien supprimer.

Filtres

name, username, email, à combiner avec _start et _limit. Exemple : /api/users?name=valeur&_limit=5.

Routes imbriquées

GET /api/users/{id}/albums : Albums de l'utilisateur
GET /api/users/{id}/todos : Todos de l'utilisateur
GET /api/users/{id}/posts : Posts de l'utilisateur

Exemples

GET Lister /api/users

Codes de retour : 200

JAVASCRIPT

fetch('https://api-placeholder.frederickagathe.fr/api/users?_limit=10')
  .then((response) => response.json())
  .then((json) => console.log(json));

GET Récupérer /api/users/{id}

Codes de retour : 200, 404

JAVASCRIPT

fetch('https://api-placeholder.frederickagathe.fr/api/users/1')
  .then((response) => response.json())
  .then((json) => console.log(json));

POST Créer /api/users

Codes de retour : 201, 400, 422

JAVASCRIPT

fetch('https://api-placeholder.frederickagathe.fr/api/users', {
  method: 'POST',
  headers: { 'Content-type': 'application/json; charset=UTF-8' },
  body: JSON.stringify({
    "name": "Jane Doe",
    "username": "jane",
    "email": "jane@exemple.com",
    "address": {
        "street": "1 rue de la Paix",
        "suite": "Apt. 12",
        "city": "Paris",
        "zipcode": "75002",
        "geo": {
            "lat": "48.8686",
            "lng": "2.3314"
        }
    },
    "phone": "01 23 45 67 89",
    "website": "exemple.com",
    "company": {
        "name": "Exemple",
        "catchPhrase": "Une accroche",
        "bs": "Une activité"
    }
}),
})
  .then((response) => response.json())
  .then((json) => console.log(json));

PUT Remplacer /api/users/{id}

Codes de retour : 200, 400, 404, 422

JAVASCRIPT

fetch('https://api-placeholder.frederickagathe.fr/api/users/1', {
  method: 'PUT',
  headers: { 'Content-type': 'application/json; charset=UTF-8' },
  body: JSON.stringify({
    "name": "Jane Doe",
    "username": "jane",
    "email": "jane@exemple.com",
    "address": {
        "street": "1 rue de la Paix",
        "suite": "Apt. 12",
        "city": "Paris",
        "zipcode": "75002",
        "geo": {
            "lat": "48.8686",
            "lng": "2.3314"
        }
    },
    "phone": "01 23 45 67 89",
    "website": "exemple.com",
    "company": {
        "name": "Exemple",
        "catchPhrase": "Une accroche",
        "bs": "Une activité"
    }
}),
})
  .then((response) => response.json())
  .then((json) => console.log(json));

PATCH Modifier /api/users/{id}

Codes de retour : 200, 400, 404, 422

JAVASCRIPT

fetch('https://api-placeholder.frederickagathe.fr/api/users/1', {
  method: 'PATCH',
  headers: { 'Content-type': 'application/json; charset=UTF-8' },
  body: JSON.stringify({
    "phone": "09 87 65 43 21"
}),
})
  .then((response) => response.json())
  .then((json) => console.log(json));

DELETE Supprimer (simulé) /api/users/{id}

Codes de retour : 204

JAVASCRIPT

fetch('https://api-placeholder.frederickagathe.fr/api/users/1', { method: 'DELETE' })
  .then((response) => console.log(response.status)); // 204, sans contenu