Documentazione di riferimento per gli sviluppatori dell'API catalogo di Microsoft Learn
Questo articolo fornisce informazioni per sviluppatori e richiedenti che implementano il catalogo API di Microsoft Learn. È anche consigliabile consultare le procedure consigliate per l'APILearn Catalog, le notesulla versione e gli articoli delle domande frequenti per supportare il percorso di sviluppo.
Endpoint API
L'API catalogo di Microsoft Learn è un'API Web basata su REST che restituisce una risposta con codifica JSON. Per richiedere il catalogo completo, invia una richiesta GET a:
https://learn.microsoft.com/api/catalog/
Nota
L'endpoint elencato sopra è l'endpoint corrente. Se si usa un endpoint precedente, funzionerà comunque come previsto al momento dell'onboarding, ma il passaggio al nuovo endpoint ha il vantaggio di rendere disponibili diverse funzionalità avanzate, come ad esempio parametri di query aggiuntivi.
Parametri di query
Di seguito sono riportati i parametri di query che possono essere inclusi nella richiesta. Sono tutti facoltativi. Devi applicare la codifica URL ai valori dei parametri di query. È possibile usare l'endpoint con uno di questi parametri, con più di uno, con tutti o con nessuno.
Importante
Se se ne usa più di uno, la query verrà valutata usando l'operatore AND.
| Nome | valore | Type | Obbligatorio | Esempio |
|---|---|---|---|---|
| locale | Singolo codice delle impostazioni locali valido dall'elenco di impostazioni locali supportate. I metadati restituiti saranno nelle impostazioni locali richieste, se disponibili. Se questo parametro non viene specificato, verrà restituita la risposta en-us. |
string | No | ?locale=en-us |
| Tipo | Elenco delimitato da virgole di uno o più oggetti di livello principale o tassonomie attualmente specificati nella risposta da restituire. I valori supportati sono compresi: modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, courses, levels, roles, products, subjects. |
string | No | ?type=modules,learningPaths |
| uid | Elenco delimitato da virgole di uno o più ID di contenuto (uid) univoci validi derivanti dai tipi di contenuto disponibili. Nota: gli uid fanno distinzione tra maiuscole e minuscole. | string | No | ?uid=learn.azure.intro-to-azure-fundamentals |
| last_modified | Operatore e datetime per filtrare in base all'ultima data di modifica degli oggetti. L'operatore include lt (minore di), lte (minore di o uguale a), eq (uguale a), gt (maggiore di), gte (maggiore di o uguale a). Quando si usa questo parametro, se non diversamente specificato, verrà usato l'operatore predefinito gte. |
string | No | ?last_modified=gte 2022-01-01 |
| popularity | Operatore e valore per filtrare in base al valore di popolarità (in un intervallo di 0-1) degli oggetti. L'operatore include lt (minore di), lte (minore di o uguale a), eq (uguale a), gt (maggiore di), gte (maggiore di o uguale a). Quando si usa questo parametro, se non diversamente specificato, verrà usato l'operatore predefinito gte. |
string | No | ?popularity=gte 0.5 |
| level | Elenco delimitato da virgole di uno o più livelli attualmente disponibili. L'elenco completo è incluso nell'oggetto levels della risposta dell'API. | string | No | ?level=beginner |
| ruolo | Elenco delimitato da virgole di uno o più ruoli attualmente disponibili. L'elenco completo è incluso nell'oggetto roles della risposta dell'API. | string | No | ?role=developer |
| product | Elenco delimitato da virgole di uno o più ruoli attualmente disponibili. L'elenco completo è incluso nell'oggetto products della risposta dell'API. L'API non supporta la gerarchia dei prodotti, quindi aggiungere ogni prodotto all'elenco che si vuole includere nella query. | string | No | ?product=azure |
| subject | Elenco delimitato da virgole di uno o più ruoli attualmente disponibili. L'elenco completo è incluso nell'oggetto subjects della risposta dell'API. L'API non supporta la gerarchia dei soggetti, quindi aggiungere ogni oggetto all'elenco da includere nella query. | string | No | ?subject=cloud-computing |
Query di esempio
Le query elencate di seguito sono esempi che consentono di farsi un'idea di ciò che è possibile richiedere e di come generare la richiesta.
| Descrizione | Query |
|---|---|
| Tutti gli elementi nell'API Catalogo di Microsoft Learn | https://learn.microsoft.com/api/catalog/ |
| Tutti i moduli in spagnolo | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| Tutti i moduli con un punteggio di popolarità pari a 0,9 o superiore | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Tutti gli oggetti di training e certificazione per principianti | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Tutti i moduli di accessibilità avanzati con un punteggio di popolarità superiore a 0,5 e aggiornati nell'ultimo mese | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
Risposta dell'API
È possibile che il servizio restituisca i codici di stato HTTP seguenti.
| Codice di stato | Descrizione |
|---|---|
| 200 | Esito positivo. Il corpo della risposta include i dati con codifica JSON. |
| 400 | Uno dei parametri di query manca o non è valido. |
| 404 | L'URL non è stato trovato sul server. |
| 500 | Errore server imprevisto. |
| 503 | Il servizio è temporaneamente non disponibile. |
Una risposta di tipo operazione completata includerà dettagli su tutti i moduli e tutti i percorsi di apprendimento, come mostrato di seguito.
Corpo della risposta
Un corpo della risposta con esito positivo verrà codificato in JSON e avrà 12 sezioni:
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
Ogni matrice ha uno o più oggetti con codifica JSON contenenti dati specifici per tale sezione della risposta.
modules: è una matrice di moduli pubblicati.units: è una matrice di unità pubblicate.learningPaths: è una matrice di percorsi di apprendimento pubblicati.appliedSkills: è una matrice di competenze applicate pubblicate.mergedCertifications: è una matrice di certificazioni pubblicate unite agli esami.certifications: è una matrice di certificazioni pubblicate.exams: è una matrice di esami pubblicati.courses: è una matrice di corsi di formazione con docente pubblicati.levels: è una matrice di possibili livelli di destinatari.products: è una matrice di possibili prodotti e servizi considerati nel catalogo.roles: è una matrice di possibili ruoli professionali.subjects: è una matrice di possibili tag di argomenti.
Record dei moduli
Record dei moduli
Ogni record per modulo avrà il formato seguente:
{
"summary": "Explore the core concepts of cloud computing and how it can help your business.",
"levels": [
"beginner"
],
"roles": [
"administrator",
"business-analyst",
"developer"
],
"products": [
"azure",
"azure-portal",
"azure-resource-manager"
],
"subjects": [
"data-visualization"
],
"uid": "learn.principles-cloud-computing",
"type": "module",
"title": "Cloud Concepts - Principles of cloud computing",
"duration_in_minutes": 62,
"rating": {
count: 2014,
average: 4.84
},
"popularity": 0.8839785477023878,
"icon_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing.svg",
"social_image_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing-social.png",
"locale": "en-us",
"last_modified": "2018-09-24T00:00:00Z",
"url": "https://learn.microsoft.com/learn/modules/principles-cloud-computing",
"firstUnitUrl": "https://learn.microsoft.com/learn/modules/principles-cloud-computing/1-introduction",
"units": [
"learn.principles-cloud-computing.1-introduction",
"learn.principles-cloud-computing.2-types-of-cloud-computing",
"learn.principles-cloud-computing.3-benefits-of-cloud-computing",
"learn.principles-cloud-computing.4-categories-of-cloud-services",
"learn.principles-cloud-computing.5-knowledge-check",
"learn.principles-cloud-computing.6-summary"
],
"number_of_children": 6
}
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
summary |
stringa | Stringa che fornisce una breve descrizione del modulo. Il valore è espresso come tag di paragrafo HTML con il testo interno che corrisponde al riepilogo. |
levels |
matrice di stringhe | Elenco dei livelli associati a questo modulo, che indicano il livello di esperienza nel ruolo necessaria per comprendere tutti gli aspetti di questo modulo. È possibile fare riferimento ai dettagli sulle unità nei record per livello. |
roles |
matrice di stringhe | Elenco dei ruoli professionali per cui questo modulo è rilevante. |
products |
matrice di stringhe | Elenco di prodotti rilevanti coperti da questo modulo. È possibile fare riferimento ai dettagli sui prodotti nei record per prodotto. |
subjects |
matrice di stringhe | Elenco di argomenti rilevanti coperti da questo percorso di apprendimento. |
uid |
stringa | Identificatore univoco per questo modulo. Questo valore sarà univoco in tutte le risorse di Microsoft Learn. |
type |
stringa | Tipo di record. Il valore sarà sempre 'module'. |
title |
stringa | Titolo per il modulo nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
duration_in_minutes |
integer | Tempo medio necessario per il completamento del modulo. |
rating |
oggetto | Contiene sia count, ovvero il numero di persone che hanno valutato il modulo, che average, ovvero un'aggregazione delle valutazioni con valore compreso tra 1 e 5 |
popularity |
double | Valore normalizzato da 0 a 1 che indica la popolarità del modulo |
icon_url |
stringa | URL completo di un'immagine SVG (100x100) che rappresenta l'immagine relativa all'attestazione digitale del modulo con sfondo trasparente. |
social_image_url |
stringa | URL completo di un'immagine PNG che rappresenta l'immagine relativa all'attestazione digitale del modulo con uno sfondo opaco rettangolare, adatta per esperienze di social media o a riquadri. Se non è disponibile per questo modulo, questa proprietà non verrà restituita nella risposta. |
locale |
stringa | Lingua in cui sono scritti i dati JSON. Questo valore corrisponderà alle impostazioni locali richieste, se disponibili, o a 'en-us' in caso contrario. |
last_modified |
data | Data dell'ultima revisione significativa del modulo. |
url |
stringa | URL completo per il modulo di Microsoft Learn nelle impostazioni locali richieste. |
firstUnitUrl |
stringa | URL completo per la prima unità del modulo di Microsoft Learn nelle impostazioni locali richieste. |
units |
matrice di stringhe | Elenco degli UID unità associati. È possibile fare riferimento ai dettagli sulle unità nei record per unità. |
number_of_children |
integer | Numero di pagine (unità) incluse nel modulo. |
Record per unità
Ogni record per unità avrà il formato seguente:
{
"uid": "learn.azure.fundamental-azure-concepts.types-of-cloud-computing",
"type": "unit",
"title": "Discuss different types of cloud models",
"duration_in_minutes": 5,
"locale": "en-us",
"last_modified": "2021-12-09T02:45:00+00:00"
},
Nota
Al record per unità non è associato alcun URL perché le unità non vengono scritte come contenuto autonomo. Devono essere eseguite in un ordine specifico per il modulo. Per questo motivo nel record per modulo viene incluso il collegamento alla pagina dei dettagli del modulo e alla prima unità in modo che gli utenti possano iniziare da tale punto e procedere esplorando tutti i contenuti. È comunque possibile usare i record per unità per ottenere informazioni dettagliate sulle unità da visualizzare in sistemi LMS o altre esperienze.
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
uid |
stringa | Identificatore univoco per questo modulo. Questo valore sarà univoco in tutte le risorse di Microsoft Learn. |
type |
stringa | Tipo di record. Il valore sarà sempre 'unit'. |
title |
stringa | Titolo dell'unità nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
duration_in_minutes |
Durata dell'unità. Se vengono aggiunti tutti i valori di duration_in_minutes delle unità associate a ogni modulo, si otterrà la durata totale del modulo. | |
locale |
stringa | Lingua in cui sono scritti i dati JSON. Questo valore corrisponderà alle impostazioni locali richieste, se disponibili, o a 'en-us' in caso contrario. |
last_modified |
data | Data dell'ultima revisione significativa del modulo. |
Record dei percorsi di apprendimento
Ogni record per percorso di apprendimento avrà il formato seguente:
{
"summary": "Azure Functions enable the creation of event driven, compute-on-demand systems that can be triggered by various external events. Learn how to leverage functions to execute server-side logic and build serverless architectures.",
"levels": [
"beginner",
"intermediate"
],
"roles": [
"developer",
"solution-architect"
],
"products": [
"azure",
"azure-portal",
"azure-functions",
"azure-cosmos-db",
"azure-cloud-shell"
],
"subjects": [
"data-visualization"
],
"uid": "learn.create-serverless-applications",
"type": "learningPath",
"title": "Create serverless applications",
"duration_in_minutes": 450,
"rating": {
count: 2014,
average: 4.84
},
"popularity": 0.8839785477023878,
"icon_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications.svg",
"social_image_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications-social.png",
"locale": "en-us",
"last_modified": "2018-12-27T00:00:00Z",
"url": "https://learn.microsoft.com/learn/paths/create-serverless-applications",
"firstModuleUrl": "https://learn.microsoft.com/learn/modules/choose-azure-service-to-integrate-and-automate-business-processes/",
"modules": [
"learn.choose-azure-service-to-integrate-and-automate-business-processes",
"learn.create-serverless-logic-with-functions",
"learn.execute-azure-function-with-triggers",
"learn.chain-azure-functions-data-using-input-output-bindings",
"learn.azure-create-long-running-serverless-workflow-with-durable-functions",
"learn-pr.develop-test-deploy-azure-functions-core-tools",
"learn.develop-test-deploy-azure-functions-with-visual-studio",
"learn.azure.monitor-github-events-with-a-function-triggered-by-a-webhook",
"learn.advocates.azure-functions-and-signalr"
],
"number_of_children": 9
}
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
summary |
stringa | Stringa che fornisce una breve descrizione del percorso di apprendimento. Il valore è espresso come tag di paragrafo HTML con il testo interno che corrisponde al riepilogo. |
levels |
matrice di stringhe | Elenco dei livelli associati a questo percorso di apprendimento, che indicano il livello di esperienza nel ruolo necessaria per comprendere tutti gli aspetti di questo percorso di apprendimento. È possibile fare riferimento ai dettagli sulle unità nei record per livello. |
roles |
matrice di stringhe | Elenco dei ruoli professionali rilevanti per questo percorso di apprendimento. |
products |
matrice di stringhe | Elenco di prodotti rilevanti coperti da questo percorso di apprendimento. È possibile fare riferimento ai dettagli sui prodotti nei record per prodotto. |
subjects |
matrice di stringhe | Elenco di argomenti rilevanti coperti da questo percorso di apprendimento. |
uid |
stringa | Identificatore univoco per questo percorso di apprendimento. Questo valore sarà univoco in tutte le risorse di Microsoft Learn. |
type |
stringa | Tipo di record. Il valore sarà sempre 'learningPath'. |
title |
stringa | Titolo per il percorso di apprendimento nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
duration_in_minutes |
integer | Tempo medio necessario per il completamento del percorso di apprendimento. Questo valore è la somma dei dati da tutti i moduli inclusi. |
rating |
oggetto | Contiene sia count, ovvero il numero di persone che hanno valutato il percorso di apprendimento, che average, ovvero un'aggregazione delle valutazioni con valore compreso tra 1 e 5 |
popularity |
double | Valore normalizzato da 0 a 1 che indica la popolarità del percorso di apprendimento |
icon_url |
stringa | URL completo di un'immagine SVG (100x100) che rappresenta il percorso di apprendimento. |
social_image_url |
stringa | URL completo di un'immagine PNG che rappresenta l'immagine relativa all'attestazione digitale del percorso di apprendimento con uno sfondo opaco rettangolare, adatta per esperienze di social media o a riquadri. Se non è disponibile per questo modulo, questa proprietà non verrà restituita nella risposta. |
locale |
stringa | Lingua in cui sono scritti i dati JSON. Questo valore corrisponderà alle impostazioni locali richieste, se disponibili, o a 'en-us' in caso contrario. |
last_modified |
data | Data dell'ultima modifica del percorso di apprendimento. |
url |
stringa | URL completo per il percorso di apprendimento in Microsoft Learn nelle impostazioni locali richieste. |
firstModuleUrl |
stringa | URL completo per il primo modulo del percorso di apprendimento in Microsoft Learn nelle impostazioni locali richieste. |
modules |
matrice di stringhe | Elenco degli UID modulo associati. È possibile fare riferimento ai dettagli sui moduli nei record per modulo. |
number_of_children |
integer | Numero di moduli inclusi nel percorso di apprendimento. |
Record delle competenze applicate
Ogni record di competenze applicate avrà il formato seguente:
{
"uid": "applied-skill.deploy-and-configure-azure-monitor",
"locale": "en-us",
"url": "https://learn.microsoft.com/en-us/credentials/applied-skills/deploy-and-configure-azure-monitor/?WT.mc_id=api_CatalogApi",
"title": "Deploy and configure Azure Monitor",
"summary": "<p>To earn this Microsoft Applied Skills credential, learners demonstrate the ability to deploy and configure monitoring for Azure infrastructure.</p>\n<p>Candidates for this assessment lab should be familiar with operating systems, networking, servers, and virtualization.</p>\n",
"levels": [
"intermediate"
],
"roles": [
"administrator"
],
"products": [
"azure-monitor",
"azure-virtual-machines",
"azure-virtual-network",
"windows-server"
],
"subjects": [
"it-management-monitoring"
],
"study_guide": [
{
"uid": "learn.wwl.deploy-configure-azure-monitor",
"type": "learningPath"
}
],
"last_modified": "2023-10-25T17:07:00+00:00"
}
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
uid |
stringa | Un identificatore univoco per questa competenza applicata: questo valore sarà univoco in tutte le funzionalità di MS Learn. |
locale |
stringa | Lingua in cui sono scritti i dati JSON. Questo valore corrisponderà alle impostazioni locali richieste, se disponibili, o a 'en-us' in caso contrario. |
title |
stringa | Titolo della competenza applicata nelle impostazioni locali richieste o in inglese (Stati Uniti) come fallback. |
summary |
stringa | Riepilogo della competenza applicata nelle impostazioni locali richieste o in inglese (Stati Uniti) come fallback. |
url |
stringa | URL completo della competenza applicata in Microsoft Learn nelle impostazioni locali richieste. |
icon_url |
stringa | URL completo di un'immagine SVG 100x100 che rappresenta la competenza applicata (se disponibile, altrimenti non inclusa). |
levels |
matrice di stringhe | Elenco dei livelli associati a questa competenza applicata. |
roles |
matrice di stringhe | Elenco dei ruoli di lavoro pertinenti per questa competenza applicata. È possibile fare riferimento ai dettagli sui ruoli nei record per ruolo. |
subjects |
matrice di stringhe | Un elenco di argomenti pertinenti trattati da questa competenza applicata. |
study_guide |
matrice di oggetti | Elenco del contenuto associato da studiare per questa competenza applicata. È possibile fare riferimento ai dettagli sugli oggetti nei relativi record associati. |
last_modified |
data | L'ultima volta che questa competenza applicata è stata modificata. |
Record di certificazione uniti
Ogni record di certificazione unito avrà il formato seguente:
{
"uid": "certification.d365-functional-consultant-manufacturing",
"title": "Microsoft Certified: Dynamics 365 Supply Chain Management, Manufacturing Functional Consultant Associate",
"summary": "<div class=\"WARNING\">\n<p>Warning</p>\n<p>This certification retired on June 30, 2023. You can renew it for at least six months after the retirement date by completing the free online assessment available on the <a href=\"/credentials/certifications/d365-functional-consultant-manufacturing/renew\">certification renewal page</a>. <a href=\"https://aka.ms/BACertPortfolioUpdatesBlog\">Read the blog post</a>.</p>\n</div>\n<p>If you’re a functional consultant or a business user with a deep understanding of manufacturing industry standards, this certification might be for you. You also need experience configuring and implementing Dynamics 365 Supply Chain Management to meet the needs of your organization. Supply chain management, manufacturing functional consultants are key resources who work with developers, solution architects, project managers, and functional consultants in finance, commerce, and supply chain.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Study the supply chain management and supply chain management, manufacturing modules on Microsoft Learn, and complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course that covers the MB-300 or MB-320 track.</li>\n<li>Take part in the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>, or join a user group.</li>\n<li>Shadow a manufacturing functional consultant in a manufacturing workstream.</li>\n<li>Get a mentor, tour manufacturing lines, and learn how things are made.</li>\n<li>Ask questions, and learn from experts and customers.</li>\n</ul>\n",
"url": "https://learn.microsoft.com/en-us/credentials/certifications/d365-functional-consultant-manufacturing/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/en-us/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
"last_modified": "2023-09-19T00:47:00+00:00",
"type": "cert",
"certification_type": "role-based",
"products": [
"dynamics-365",
"dynamics-finance"
],
"levels": [
"intermediate"
],
"roles": [
"functional-consultant"
],
"subjects": [],
"renewal_frequency_in_days": 0,
"prerequisites": [],
"skills": [
"Describe finance and operations apps, and extend apps by using Microsoft Power Platform technologies",
"Configure administrative features and workflows",
"Manage finance and operations data",
"Validate and support solutions",
"Configure Dynamics 365 Supply Chain Management, Manufacturing",
"Manage manufacturing processes",
"Implement master planning for production",
"Implement other manufacturing features"
],
"recommendation_list": [],
"study_guide": [],
"exam_duration_in_minutes": 0,
"locales": [],
"providers": [],
"career_paths": []
}
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
uid |
stringa | Identificatore univoco di questa certificazione. Questo valore sarà univoco in tutte le risorse di Microsoft Learn. |
title |
stringa | Titolo della certificazione nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
summary |
stringa | Riepilogo della certificazione nelle impostazioni locali richieste o in inglese (Stati Uniti) come fallback. |
url |
stringa | URL completo della certificazione in Microsoft Learn nelle impostazioni locali richieste. |
icon_url |
stringa | URL completo di un'immagine SVG (100x100) che rappresenta la certificazione. |
last_modified |
data | L'ultima volta che questa certificazione è stata modificata. |
type |
stringa | Tipo di record. Il valore sarà sempre 'cert'. |
certification_type |
stringa | Tipo di certificazione. I valori possibili sono 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
products |
matrice di stringhe | Un elenco dei prodotti pertinenti trattati da questa certificazione. È possibile fare riferimento ai dettagli sui prodotti nei record per prodotto. |
levels |
matrice di stringhe | Elenco dei livelli associati a questa certificazione, che indicano il livello di esperienza nel ruolo necessaria per comprendere tutti gli aspetti degli esami di questa certificazione. È possibile fare riferimento ai dettagli sulle unità nei record per livello. |
roles |
matrice di stringhe | Elenco dei ruoli professionali pertinenti per questa certificazione. È possibile fare riferimento ai dettagli sui ruoli nei record per ruolo. |
subjects |
matrice di stringhe | Un elenco dei soggetti pertinenti trattati da questa certificazione. |
renewal_frequency_in_days |
integer | Numero di giorni prima della scadenza di questa certificazione, che deve dopo essere rinnovata. Se il valore è 0, la certificazione non scade. |
prerequisites |
matrice di stringhe | Elenco dei prerequisiti consigliati per ottenere questa certificazione. È possibile fare riferimento ai dettagli sulle certificazioni nei record di certificazione. |
skills |
matrice di stringhe | Elenco delle competenze misurate per l'esame richiesto per questa certificazione. |
recommendation_list |
matrice di stringhe | Elenco delle raccomandazioni correlate a questa certificazione. |
study_guide |
matrice di oggetti | Elenco del contenuto associato da studiare per questa certificazione. È possibile fare riferimento ai dettagli sugli oggetti nei relativi record associati. |
exam_duration_in_minutes |
integer | Numero di minuti assegnati per completare l'esame. |
locales |
matrice di stringhe | Un elenco delle lingue in cui è disponibile questa certificazione. |
providers |
matrice di oggetti | Elenco dei provider per questa certificazione. Il tipo descrive il provider e un URL completo con un collegamento per pianificare un esame con il provider. |
career_paths |
matrice di oggetti | Elenco dei percorsi di carriera per questa certificazione. |
Nota
Le certificazioni che richiedono un solo esame verranno restituite come parte di questa proprietà mergedCertifications.
Record per certificazione
Ogni record per certificazione avrà il formato seguente:
{
"uid": "certification.d365-functional-consultant-customer-service",
"title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate",
"subtitle": "Microsoft Dynamics 365 Customer Service functional consultants are responsible for implementing omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction.",
"url": "https://learn.microsoft.com/cert-exam-sandbox/cert/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
"type": "cert",
"certification_type": "role-based",
"exams": [
"exam.77-881"
],
"levels": [
"intermediate"
],
"roles": [
"functional-consultant"
],
"study_guide": [
{
"uid": "learn.get-started-with-d365",
"type": "module"
},
{
"uid": "learn.d365-notebook",
"type": "module"
},
{
"uid": "learn.d365-fundamentals",
"type": "learningPath"
}
]
}
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
uid |
stringa | Identificatore univoco di questa certificazione. Questo valore sarà univoco in tutte le risorse di Microsoft Learn. |
title |
stringa | Titolo della certificazione nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
subtitle |
stringa | Sottotitolo della certificazione nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
url |
stringa | URL completo della certificazione in Microsoft Learn nelle impostazioni locali richieste. |
icon_url |
stringa | URL completo di un'immagine SVG (100x100) che rappresenta la certificazione. |
type |
stringa | Tipo di record. Il valore sarà sempre 'cert'. |
certification_type |
stringa | Tipo di certificazione. I valori possibili sono 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
exams |
matrice di stringhe | Elenco degli esami associati necessari per questa certificazione. È possibile fare riferimento ai dettagli sulle unità nei record per certificazione. |
levels |
matrice di stringhe | Elenco dei livelli associati a questa certificazione, che indicano il livello di esperienza nel ruolo necessaria per comprendere tutti gli aspetti degli esami di questa certificazione. È possibile fare riferimento ai dettagli sulle unità nei record per livello. |
roles |
matrice di stringhe | Elenco dei ruoli professionali pertinenti per questa certificazione. È possibile fare riferimento ai dettagli sui ruoli nei record per ruolo. |
study_guide |
matrice di oggetti | Elenco del contenuto associato da studiare per questa certificazione. È possibile fare riferimento ai dettagli sugli oggetti nei relativi record associati. |
Nota
Le certificazioni che richiedono più esami saranno presenti in questo record delle certificazioni che fanno riferimento alla matrice di esami.
Record per esame
Ogni record per esame avrà il formato seguente:
{
"uid": "exam.77-881",
"title": "Word 2010",
"subtitle": "The core-level Microsoft Office Word 2010 user should be able to navigate Microsoft Office Word 2010 software at the feature and functional level. They should be familiar with and know how to use at least 80 percent of the features and capabilities of Microsoft Office Word 2010. The core-level user should be able to use Microsoft Office Word 2010 to create and edit professional-looking documents for a variety of purposes and situations. Users would include people from a wide variety of job roles from almost all areas of professional, student, and personal life.",
"display_name": "77-881",
"url": "https://learn.microsoft.com/cert-exam-sandbox/exam/77-881/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
"pdf_download_url": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
"practice_test_url": "https://www.mindhub.com/70-413-Designing-and-Implementing-a-Server-Infrast-p/mu-70-413_p.htm?utm_source=microsoft&utm_medium=certpage&utm_campaign=msofficialpractice",
"practice_assessment_url": "https://learn.microsoft.com/en-us/certifications/exams/{exam}/practice/assessment?assessment-type=practice&assessmentId={assessmentId}",
"locales": [],
"type": "exam",
"courses": [
"course.pl-200t00",
"course.mb-230t01"
],
"levels": [
"beginner"
],
"roles": [
"business-user"
],
"products": [
"office-word"
],
"providers": [],
"study_guide": [
{
"uid": "learn.get-started-with-word-2010",
"type": "module"
},
{
"uid": "learn.office2010-notebook",
"type": "module"
},
{
"uid": "learn.office2010-fundamentals",
"type": "learningPath"
}
]
}
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
uid |
stringa | Identificatore univoco di questo esame. Questo valore sarà univoco in tutte le risorse di Microsoft Learn. |
title |
stringa | Titolo dell'esame nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
subtitle |
stringa | Sottotitolo dell'esame nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
display_name |
stringa | Nome visualizzato dell'esame nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
url |
stringa | URL completo dell'esame in Microsoft Learn nelle impostazioni locali richieste. |
icon_url |
stringa | URL completo di un'immagine SVG (100x100) che rappresenta l'esame. |
pdf_download_url |
stringa | URL completo del PDF che illustra le competenze misurate da questo esame. |
practice_test_url |
stringa | URL completo di un test di esercitazione associato all'esame. |
practice_assessment_url |
stringa | URL completo di una valutazione pratica gratuita associata all'esame. |
locales |
matrice di stringhe | Elenco delle lingue in cui viene offerto questo esame. |
type |
stringa | Tipo di record. Il valore sarà sempre 'exam'. |
courses |
matrice di stringhe | Elenco degli UID corso associati. È possibile fare riferimento ai dettagli sui corsi nei record per corso. |
levels |
matrice di stringhe | Elenco dei livelli associati a questo esame, che indicano il livello di esperienza nel ruolo necessaria per comprendere tutti gli aspetti di questo esame. È possibile fare riferimento ai dettagli sulle unità nei record per livello. |
roles |
matrice di stringhe | Elenco dei ruoli professionali pertinenti per questo esame. È possibile fare riferimento ai dettagli sui ruoli nei record per ruolo. |
products |
matrice di stringhe | Elenco di prodotti pertinenti coperti da questo esame. È possibile fare riferimento ai dettagli sui prodotti nei record per prodotto. |
providers |
matrice di oggetti | Elenco di provider per questo esame. Il tipo descrive il provider e un URL completo con un collegamento per pianificare un esame con il provider. |
study_guide |
matrice di oggetti | Elenco del contenuto associato da studiare per questo esame. È possibile fare riferimento ai dettagli sugli oggetti nei relativi record associati. |
Record per corso con docente
Ogni record per corso avrà il formato seguente:
{
"uid": "course.mb-230t01",
"course_number": "MB-230T01",
"title": "Microsoft Dynamics 365 Customer Service - added non-exist studyguide",
"summary": "Microsoft Dynamics 365 Customer Service offers any organization an opportunity for customer success. Using tools such as automatic case creation and queue management frees up your time to dedicate it where you can have a greater impact, directly with your customers. Join our team of globally recognized experts as they take you step by step from creating cases to interacting with customers to resolving those cases. Once you’ve resolved those cases you can learn from data analysis the key details to help you resolve similar cases faster or avoid new issues altogether. A Dynamics 365 Customer Engagement Functional Consultant is responsible for performing discovery, capturing requirements, engaging subject matter experts and stakeholders, translating requirements, and configuring the solution and applications. The Functional Consultant implements a solution using out of the box capabilities, codeless extensibility, application and service integrations.",
"duration_in_hours": 72,
"url": "https://learn.microsoft.com/cert-exam-sandbox/course/mb-230t01/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/media/learn/certification/course.svg",
"locales": [
"en"
],
"type": "course",
"certification": "certification.d365-functional-consultant-customer-service",
"exam": "exam.77-881",
"levels": [
"intermediate"
],
"roles": [
"functional-consultant"
],
"products": [
"dynamics-365"
],
"study_guide": [
{
"uid": "learn.align-requirements-in-azure",
"type": "module"
},
{
"uid": "learn.manage-resources-in-azure",
"type": "learningPath"
}
]
},
Dettagli del campo
| Campo | Tipo | Description |
|---|---|---|
uid |
stringa | Identificatore univoco di questo corso co docente. Questo valore sarà univoco in tutte le risorse di Microsoft Learn. |
course_number |
stringa | Identificatore del numero di corso con docente. |
title |
stringa | Titolo del corso con docente nelle impostazioni locali richieste oppure titolo in inglese (Stati Uniti) come fallback. |
summary |
stringa | Stringa che fornisce una breve descrizione del corso con docente. Il valore è espresso come tag di paragrafo HTML con il testo interno che corrisponde al riepilogo. |
duration_in_hours |
integer | Tempo medio in ore necessario per completare il corso con docente guidato. |
url |
stringa | URL completo della pagina dei dettagli del corso con docente in Microsoft Learn nelle impostazioni locali richieste. |
icon_url |
stringa | URL completo di un'immagine SVG (100x100) che rappresenta l'attestazione digitale del corso con docente. |
locales |
matrice di stringhe | Elenco di lingue in cui viene ufficialmente offerto questo corso con docente. I partner per la formazione possono supportare altre lingue. |
type |
stringa | Tipo di record. Il valore sarà sempre 'course' per i corsi con docente. |
certification |
stringa | Certificazione associata al corso con docente. |
exam |
stringa | Esame associato al corso con docente. |
levels |
matrice di stringhe | Elenco dei livelli associati a questo corso con docente, che indicano il livello di esperienza nel ruolo necessaria per comprendere tutti gli aspetti di questo corso. È possibile fare riferimento ai dettagli sulle unità nei record per livello. |
study_guide |
matrice di oggetti | URL completo del PDF che illustra le competenze misurate da questa certificazione. |
Record per livello, prodotto, ruolo e argomento
Le raccolte levels, products, roles e subjects specificano nomi descrittivi per i valori usati nei dati dei moduli e dei percorsi di apprendimento. Tutte e quattro le raccolte hanno la stessa forma:
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
Il valore id corrisponderà ai valori per i livelli, i prodotti, i ruoli e gli argomenti inclusi nelle altre voci del catalogo. Il valore name associato fornisce un nome appropriato in inglese per la voce. La matrice children è facoltativa e consente l'ordinamento gerarchico per i valori con relazioni figlio, ad esempio prodotti.
Ecco ad esempio un set di ruoli possibili:
{
...
"roles": [
{
"id": "administrator",
"name": "Administrator"
},
{
"id": "ai-engineer",
"name": "AI Engineer"
},
{
"id": "business-analyst",
"name": "Business Analyst"
},
{
"id": "developer",
"name": "Developer"
},
...
]
}
Ecco un set di prodotti di esempio, con elementi figlio inclusi per offrire una categoria di prodotti più specifica.
{
...
"products": [
{
"id": "dotnet",
"name": ".NET",
"children": [
{ "id": "dotnet-core", "name": ".NET Core" },
{ "id": "dotnet-standard", "name": ".NET Standard" },
{ "id": "aspnet-core", "name": "ASP.NET Core" },
{ "id": "ef-core", "name": "Entity Framework Core" }
]
},
{
"id": "ms-graph",
"name": "Microsoft Graph"
},
{
"id": "office",
"name": "Office",
"children": [
{ "id": "office-365", "name": "Office 365" },
{ "id": "office-add-ins", "name": "Office Add-ins" },
{ "id": "office-teams", "name": "Teams" }
]
},
{
"id": "sql-server",
"name": "SQL Server"
},
...
]
}
Esempi di codice
È possibile chiamare l'API Catalogo di Microsoft Learn in diversi modi ma i codici di esempio riportati di seguito illustrano come può essere usata.
jQuery
$(function() {
var params = {
locale:'en-us'
};
$.ajax({
url: "https://learn.microsoft.com/api/learn/catalog?" + $.param(params),
type: "GET"
}).done(function(data) {
alert("success");
}).fail(function(error) {
alert("error");
});
})
.NET C#
public string GetCatalogData()
{
var client = new WebClient();
client.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko");
var response = client.DownloadString("https://learn.microsoft.com/api/learn/catalog?locale=en-us");
dynamic parsedJson = JsonConvert.DeserializeObject(response);
JsonConvert.SerializeObject(response, Formatting.Indented);
return Convert.ToString(response);
}
PHP con l'estensione cURL
<?php
// From URL to get webpage contents.
$url = "https://learn.microsoft.com/api/learn/catalog";
// Initialize a CURL session.
$ch = curl_init();
// Return Page contents.
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
//grab URL and pass it to the variable.
curl_setopt($ch, CURLOPT_URL, $url);
$result = curl_exec($ch);
echo $result;
?>
PYTHON 3 con la libreria 'requests'
#!/usr/bin/env python3
#Using Python 3.8.2 install 5/6/2020
import requests
import json
#if given error 'response / requests not defined', install requests via 'pip install requests' in the command line
parameters= {"locale": "en-us"}
response = requests.get("https://learn.microsoft.com/api/learn/catalog/", parameters)
#print(response.status_code)
rawJson = response._content
#Create python objects based on the data using json.loads
data = json.loads(rawJson)
print(data)
Passaggi successivi
Esaminare le risorse seguenti per facilitare il percorso di sviluppo: