Jlc/cert url programs

[johanseto]

Description

• Add certificate url to program metadata endpoint.
• Add query param to load only the certificated URL filter. &certificated_only=true

Jira story: https://edunext.atlassian.net/browse/FUTUREX-1491

Testing instructions

• Checkout this branch.
• Configure a user with a generated certificate.

- Use the api using the national_id of that user. eg `/eox-nelp/api/programs/v1/program-lookup/?national_id=1234567890` - Check certificate URL. - Filter by `certificated_only=true` queryparam. - Check the result shows only the certificated.

Screencast.from.17-10-25.10.54.47.webm

• Check the certificate url Certificate_URL field works.

[andrey-canon]

In general, the code looks good.
What really concerns me is the mixed functionality in the following endpoint:

/eox-nelp/api/programs/v1/program-lookup/

Originally, this returned the list of all programs.
On the other hand, we also have:

/eox-nelp/api/programs/v1/program-lookup/?national_id=1234567890

which returns the programs related to a specific user.

However, with these new changes, the endpoint:

/eox-nelp/api/programs/v1/program-lookup/

— as I understand it — will now start returning certificate information for the user making the request.
I personally see this endpoint as something not tied to any specific user, simply returning general program information.
That makes me think a small refactor would make more sense.

Suggested structure:

• GET /eox-nelp/api/programs/v1/program-lookup/
  → Returns all programs.

• GET /eox-nelp/api/programs/v1/program-lookup/?query=
  → Returns all programs filtered by the query params (only for program filters).

• GET /eox-nelp/api/programs/v1/user-programs/<national_id or id>
  → Returns the programs for a specific user and can support the filters proposed in this PR.

Alternatively:

/eox-nelp/api/programs/v1/user-programs/all/?national_id=xxx

• If national_id is not provided, we could return a Bad Request.
• We could also return all results by default, but that might be excessive.

Personally, I prefer:

/eox-nelp/api/programs/v1/user-programs/<national_id or id>

But this should definitely be discussed with the client.

[andrey-canon]

why are you keeping this invalid format ? why do you need the certificate path ?

[johanseto]

New workflow of the endpoint.

Screencast.from.29-10-25.18.33.38.webm

[andrey-canon]

could you please include the last field(completion_date) asked by the client ?

[johanseto]

could you please include the last field(completion_date) asked by the client ?

cce00ec

[andrey-canon]

LGTM and the basic functionality is working for me

2025-11-07.17-53-10.mp4