API

Desplegament

Si es treballa en local, les peticions es farán a http://localhost:3000 sino la URL es https://apps-api.escoladeltreball.org/

S'ha de crear un secret per a la password de la DB en l'entorn on se desplegui (stg/prod)

echo "password" | docker secret create db_api_password -

Autenticació

1. Sol·licitar token envian les dades com Query Params amb Postman (o similar)

POST(/login)

2. Adjuntar el token a la capçalera de qualsevol altre petició (Authentication: Bearer Token)

Peticions CURL

Login per demanar Token

Genera un access token.

• URL: /login
• Método: POST
• Headers: Content-Type: application/json
• Body exemple:

{
  "usr": "admin"
}

• Resposta:

{
    "token": "6IkpXVCJ9.eyJpYXQiOjE3NjA1NDc0NjN9.N8s4126kKRMB3VfCWw7b8VpMpGyvjF4LUBzVsX8pT5o"
}

Alumnat pendents de crear

Llista alumnat pendents de crear

• URL: /usuaris/alumnat/pendents
• Método: GET
• Headers: Content-Type: application/json
• Headers: Content-Type: Authorization: Bearer 6IkpXVCJ9....
• Resposta:

[
    {
        "accio": "A",
        "uid": "a211353frds",
        "domini": "con",
        "grup_ldap": "bcpe2",
        "grup_google": "2bcpe",
        "nom": "Fernando",
        "cognoms": "Torre",
        "password": "00000000"
    }
]

Confirmar alta alumnat

Confirma l’alta d’un alumne/a

• URL: /usuaris/alumnat/confirma
• Método: POST
• Headers: Content-Type: application/json
• Headers: Content-Type: Authorization: Bearer 6IkpXVCJ9....
• Body exemple:

{
  "uid": "1231545"
}

• Resposta:

{
    "msg": "Alta de 1231545 confirmada"
}

Obtenir llista treballadors donats d'alta

Obtenir llista treballadors pendents

• URL: /usuaris/treballadors/pendents
• Método: GET
• Headers: Content-Type: application/json
• Headers: Content-Type: Authorization: Bearer 6IkpXVCJ9....
• Resposta:

[
    {
        "accio": "A",
        "id": 27136,
        "domini": "con",
        "grup": "con",
        "nom": "Cristina",
        "cognoms": "Perez Aixa"
    }
]

Obtenir UID treballadors

Retorna l’uid del treballador

• URL: /usuaris/treballadors/generar_uid
• Método: POST
• Headers: Content-Type: application/json
• Headers: Content-Type: Authorization: Bearer 6IkpXVCJ9....
• Body exemple:

{
  "id_treballador": "1231545"
}

• Resposta:

[
    {
    "uid": "dtriano"
    }
]

Confirma treballador

Confirma que s’ha donat d’alta un treballador

• URL: /usuaris/treballadors/confirmacio
• Método: POST
• Headers: Content-Type: application/json
• Headers: Content-Type: Authorization: Bearer 6IkpXVCJ9....
• Body exemple:

{
  "id_treballador": "1231545",
  "uid": "1231545",
  "password": "1231545"
}

• Resposta:

[
    {
    "msg": "✅ Treballador confirmat: $uid}"
    }
]