.. _api-users:

Users
=====

Change Dahl password
--------------------

Para cambiar la contraseña del usuario en la plataforma de Dahl se puede realizar la
siguente llamada con Authorization-Dahl en las cabeceras:

.. http:patch:: /api/v1/users/me/change-password/

    **Ejemplo de petición**:

    .. sourcecode:: http

        PATCH /api/v1/users/me/change-password/ HTTP/1.1
        Content-Type: application/json

        {
            "password": "password",
            "new_password": "potato",
        }


List shipments
--------------

Obtiene la lista de envíos de un usuario a partir de su número de teléfono
de su perfil de Dahl.

.. http:get:: /api/v1/users/me/shipments/

    **Ejemplo de petición**:

    .. sourcecode:: http

        GET /api/v1/users/me/shipments/ HTTP/1.1


    **Ejemplo de respuesta**:

    .. sourcecode:: http

        HTTP/1.1 200 OK
        Content-Type: application/json

        [
            {
                "RefNo": "8919235801",
                "YourRefNo": "1015397019",
                "SId": "00373325083212484OJ3",
                "SService": "Business",
                "SStatusTxt": "En route",
                "CSTrURL": None,
                "MyBoxesTrURL": "https://myboxes.com/?shipmentKey=120605A6",
                "SKey": "120605a6-fc18-479e-96fc-99159bed2a44",
                "SStatusDTime": "2021-03-24 09:17",
            },
        ]


Request restore password
------------------------

.. http:post:: /api/v1/request-restore-code/

    **Ejemplo de petición**:

    .. sourcecode:: http

        POST /api/v1/request-restore-code/ HTTP/1.1
        Content-Type: application/json

        {
            "username": "user@example.com"
        }


    **Ejemplo de respuesta**:

    .. sourcecode:: http

        HTTP/1.1 202 Accepted


Restore password
----------------

.. http:post:: /api/v1/restore-password/

    **Ejemplo de petición**:

    .. sourcecode:: http

        POST /api/v1/restore-password/ HTTP/1.1
        Content-Type: application/json

        {
            "username": "user@example.com"
            "password": "Passw0rd",
            "code": "1000101"
        }


    **Ejemplo de respuesta**:

    .. sourcecode:: http

        HTTP/1.1 202 Accepted