# API Public

###  Récupérer les notes et les validations de compétences d'un apprenant

<mark style="color:blue;">`GET`</mark> `{{URL}}/api/v1/grades`

#### Query Parameters

Un des deux est obligatoire

| Name                                        | Type   | Description                         |
| ------------------------------------------- | ------ | ----------------------------------- |
| studentId<mark style="color:red;">\*</mark> | String | L'id de l'utilisateur dans votre SI |
| email                                       | String | L'email de l'utilisateur            |

{% tabs %}
{% tab title="200: OK " %}

<pre class="language-json"><code class="lang-json">// La réponse sera de type et vous permet d'accéder à la moyenne globale et aussi à la moyenne par bloc

{
    "studentName": "Prénom nom de l'apprenant",
    "userId": "id dans le SI Campus skills",
    "sessions": [
<strong>        "sessionId": "id de la session dans le SI Campus skills",
</strong>	"sessionName": "nom de la session",
	"autoValidationMean": "Moyenne autoévaludation",
	"validationMean": "Moyenne évaluation",
	"companyValidationMean": "Moyenne validation tuteur entreprise",
        "blocks": [
		"blockId": "id dans le SI Campus skills",
		"blockName": "CONSEIL EN INGÉNERIE IMMOBILIER",
		"autoValidationMean": "Moyenne autoévaludation",
	        "validationMean": "Moyenne évaluation",
	        "companyValidationMean": "Moyenne validation tuteur entreprise",
		"skills": [
		{
			"skillName": "Nom de la compétence",
			"autoValidationScore": "Score d'autoevaluation",
			"autoValidationGrade": "Note d'autoevaluation de la compétence sur 1",
			"autoValidationLegend": "Signification sur l'échelle du score",
			"validationGrade": "Note d'evaluation par le centre sur 1",
			"validationLegend": "Signification sur l'échelle du score",
			"validationScore": "Score d'evaluation",
			"companyValidationScore": "Score d'evaluation par l'entreprise",
			"companyValidationGrade": "Note d'evaluation par l'entreprise sur 1",
			"companyValidationLegend": "Signification sur l'échelle du score",
	       },
        ],
        
    ],

}
</code></pre>

{% endtab %}
{% endtabs %}

### Récupérer l'avancement des livrets pour une session

<mark style="color:blue;">`GET`</mark> `{{URL}}/api/sync/v1/get-training-progress-by-students`

Headers

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

#### Example Request

```json
{
  "codeSchool": "identifiant de l'ecole précédemment transmis",
}
```

```

// La réponse sera un tableau des contrats des apprenants

[
    {
        "_id": "j5LxLDrPPtu4GtHFj",
        "studentName": "Agathe BATEAU",
        "tutorName": "Eric VOITURE",
        "tutorSchoolName": "Julie AVION",
        "companyName": " APPLE",
        "reports": [
            {
                "name": "Intégration en entreprise",
                "reportDone": true,
                "isLate": true,
                "dateOfReport": "2023-09-27T00:00:00.000Z"
            },
         {
                "name": "Attestation d'expérience au milieu professionnel",
                "reportDone": false,
                "isLate": false,
                "dateOfReport": "2025-05-07T07:17:00.000Z"
            },
            ...
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.campus-skills.com/api-public/en-cours.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.