RechercheFacture - Alexis-Savoie/neodomo_api GitHub Wiki

Recherche de factures

Permet de rechercher des factures selon certains critères.

URL : /admin/searchBill

Méthode : POST

Authentification requise : OUI

Headers

{ "Authorization": "Bearer [token]" }

Données optionnel

{
    "idBill": "[string]",    
    "numberBill": "int]",
    "emailBuyer": "[string]",
    "priceMin": "[number int]",
    "priceMax": "[number int]",
    "createdAtFrom": "[date]",
    "createdAtAt": "[date]",
    "idProduct": "[string]"
}

Example de données

{
    "numberBill": "389",
    "emailBuyer": "[email protected]",
    "priceMin": "5.0",
    "priceMax": "30.0",
    "createdAtFrom": "2021-01-01T00:00:00Z",
    "createdAtAt": "2021-01-03T00:00:00Z",
    "idProduct": "507f1f77bcf86cd799439011"
}

Réponse(s) en cas de succès

Condition : Résultat non vide

Code : 200

Contenu :

{
    "error": false,
    "message": "succès (non-vide)",
    "bills": {
        "idBill": "XXX",
        "numberBill": "XXX",
        "emailBuyer": "XXX",
        "description": "XXX",
        "price": "XXX",
        "paymentMethod": "XXX",
        "createdAt": "YYYY-MM-DDTHH:MM:SSZ",
        "idProduct": "XXX"
    }
}

Condition : Résultat vide

Code : 200

Contenu :

{
    "error": false,
    "message": "succès (vide)"
}

Réponse(s) en cas d'erreur

Condition : Token invalide

Code : 401

Contenu :

{
    "error": true,
    "message": "Votre token n'est pas correct"
}

Condition : L'une des données envoyés dans la requête est invalide.

Code : 403

Contenu :

{
    "error": true,
    "message": "Une ou plusieurs données est invalide"
}

Explication

Après la vérification des données, on effectue un find avec mongoose qui prend un argument un objet composé des données envoyés et en renvoie le résultat à l'administrateur.