Aprenda a documentação de referência para desenvolvedores da API Platform

Este artigo fornece informações para programadores e integradores que implementam a API da Microsoft Learn Platform. Recomendamos também consultar a Visão Geral da API da Plataforma Learn, notas de atualização e artigos sobre perguntas frequentes para apoiar a sua jornada de desenvolvimento.

Pontos de extremidade da API

Os endpoints do catálogo da API da Microsoft Learn Platform são um conjunto de APIs Web autenticadas baseadas em REST que retornam uma resposta codificada em JSON.

Os pontos finais estão acessíveis em:

https://learn.microsoft.com/api/v1

Observação

Se estiveres a usar um endpoint diferente, mais antigo, continuará a funcionar como esperado até junho de 2026, altura em que a antiga API do Catálogo não autenticada começará a ser obsoleta. Se tiver mais perguntas, contacte o LearnPlatformAPIMigration@microsoft.com.

Casos de uso

Authentication

As APIs REST da Learn Platform utilizam o Microsoft Entra ID para autenticação. Antes de fazer chamadas à API, precisa de escolher um método de acesso, e a sua aplicação cliente deve autenticar-se com credenciais válidas.

Acesso somente ao aplicativo

Quando a sua aplicação acede diretamente ao Learn, o acesso não está ligado a nenhum utilizador individual. A aplicação liga diretamente às APIs usando a sua própria identidade, este cenário é de acesso apenas por app. Saiba mais sobre a Microsoft Identity Platform.

Para começar, precisa de uma identidade válida na Microsoft Identity Platform, que pode ser um registo de aplicação ou uma identidade gerida. Idealmente, cada parceiro deveria ter uma identidade única para simplificar a gestão das quotas e dos parceiros. Utilizar uma identidade gerida atribuída pelo utilizador pode ajudar a unificar identidades geridas entre diferentes serviços.

Depois de configurar a sua identidade do Entra ID, obtenha um token de acesso do Entra ID com o âmbito definido em https://learn.microsoft.com/.default como prova de autenticação. Inclua o token de acesso no cabeçalho de Autorização HTTP ao fazer pedidos de API REST ao Learn.

Acesso delegado

Quando um utilizador iniciar sessão na sua aplicação e a usar para aceder ao Learn, a aplicação terá primeiro de pedir permissão para aceder a este recurso em nome do utilizador. Este cenário chama-se acesso delegado. Saiba mais sobre a Microsoft Identity Platform.

Para começar, é necessário registar um registo de aplicação. Assim que o registo da sua aplicação estiver configurado, a sua aplicação precisa de pedir ao utilizador que conceda um âmbito específico, ou conjunto de escopos, para aceder ao Learn em nome do utilizador. O Learn fornece uma lista de escopos para acesso detalhado a recursos. A lista de âmbitos inclui:

https://learn.microsoft.com/PublicContent.Read.All: Este âmbito permite aos utilizadores aceder a conteúdos públicos no Learn como se fossem o utilizador autenticado.

Parâmetros de consulta

Seguem-se os parâmetros de consulta que o pedido pode incluir. Apenas é necessária a versão da API e a versão atual é 2023-11-01-preview. Deve codificar em URL os valores dos parâmetros de consulta. Pode usar o endpoint com um, alguns ou todos estes parâmetros.

Importante

Se usar mais do que uma, a consulta é avaliada usando o operador AND; Valores delimitados por vírgulas dentro de um filtro são combinados por OU.

Nome	Valor	Tipo	Obrigatório	Example
Versão da API	A versão da API é especificada como parâmetro de consulta de versão API e usa yyyy-MM-dd para versões estáveis e yyyy-MM-dd-preview para versões de pré-visualização. O parâmetro de consulta de versão da API é necessário para cada pedido de API.	cadeia (de caracteres)	Yes	`?api-version=2023-11-01-preview`
região	Um único código local válido da lista de locais suportados. Os metadados retornados estarão na localidade solicitada, se disponíveis. Se este parâmetro não for fornecido, a `en-us` resposta será devolvida.	cadeia (de caracteres)	Não	`?locale=en-us`
id	Uma lista separada por vírgulas de um ou mais IDs exclusivos de conteúdo (uid) válidos dos tipos de conteúdo disponíveis. Nota: os UIDs diferenciam maiúsculas de minúsculas.	cadeia (de caracteres)	Não	`?uid=learn.azure.intro-to-azure-fundamentals`
updatedAt.gt	Um operador e datetime para filtrar pela data da última modificação de objetos. O operador inclui `gt` (maior que), `gte` (maior que ou igual a). Quando usas este parâmetro, o operador será `gt` por defeito se não for especificado.	cadeia (de caracteres)	Não	`?updatedAt.gt=2022-01-01`
níveis	Uma lista separada por vírgulas de um ou mais dos níveis que atualmente temos disponíveis (a lista completa encontra-se no objeto de níveis da resposta da API).	cadeia (de caracteres)	Não	`?levels=beginner`
roles	Uma lista separada por vírgulas de um ou mais dos papéis que atualmente temos disponíveis (a lista completa está no objeto de papéis da resposta da API).	cadeia (de caracteres)	Não	`?roles=developer`
products	Uma lista separada por vírgulas de um ou mais dos papéis que atualmente temos disponíveis (a lista completa está no objeto products da resposta da API). A API não suporta hierarquia de produtos, por isso adiciona todos os produtos à lista que queres incluir na tua consulta.	cadeia (de caracteres)	Não	`?products=azure`
indivíduos	Uma lista separada por vírgulas de uma ou mais das funções que atualmente temos disponíveis (a lista completa está no objeto subjects da resposta da API). A API não suporta hierarquia de assuntos, por isso adiciona todos os assuntos à lista que queres incluir na tua consulta.	cadeia (de caracteres)	Não	`?subjects=cloud-computing`
maxpagesize	O número máximo de recursos a incluir numa única resposta. O valor padrão é 30. O valor máximo permitido é 100.	cadeia (de caracteres)	Não	`?maxpagesize=50`

Resposta da API

O serviço pode devolver os seguintes códigos de estado HTTP.

Código de estado	Description
200	Sucesso. O corpo da resposta inclui os dados codificados em JSON.
400	Um dos parâmetros de consulta está em falta ou não é válido.
401	Consulta não autorizada.
404	A URL não foi encontrada no servidor.
429	O pedido foi limitado pela taxa.
500	Erro inesperado do servidor.
503	O serviço está temporariamente indisponível.

Uma resposta bem-sucedida incluirá detalhes para cada endpoint, conforme mostrado abaixo.

Corpo da resposta

Resposta do módulo

Registos do módulo

Cada registo de módulo terá o seguinte formulário:

{
  "type": "module",
  "id": "learn.wwl.fundamentals-generative-ai",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/",
  "locale": "en-us",
  "title": "Introduction to generative AI and agents",
  "durationInMinutes": 37,
  "summary": "Ever wondered how AI can create content, answer questions, and assist with tasks? This module introduces you to the world of generative AI and agents.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/fundamentals-generative-ai.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "units": [
    {
      "id": "learn.wwl.fundamentals-generative-ai.introduction"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.language-models"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.writing-prompts"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.agents"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.exercise-ai-agent"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.knowledge-check"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.summary"
    }
  ],
  "updatedAt": "2025-12-23T00:20:00.0000000Z"
}

Detalhes do imóvel

Propriedade	Tipo	Obrigatório	Description
`type`	`enum`	Yes	Discriminador de tipo. Permitido: `module`.
`id`	`string`	Yes	Identificador de módulo globalmente único.
`url`	`uri`	Yes	URL totalmente qualificado para o módulo na localização solicitada.
`locale`	`string`	Yes	Localidade do conteúdo do módulo. Por defeito, altera para `en-us` se a localização solicitada não estiver disponível.
`title`	`string`	Yes	Título do módulo localizado.
`durationInMinutes`	`integer`	Yes	Tempo médio de conclusão do módulo em minutos.
`summary`	`string`	Yes	Breve descrição do módulo.
`iconUrl`	`uri`	Yes	URL para um ícone de módulo transparente 100×100 SVG.
`levels`	`Level[]`	Yes	Níveis de experiência associados a este módulo.
`roles`	`Role[]`	Yes	Funções relevantes.
`products`	`Product[]`	Yes	Classificações de produtos relevantes.
`subjects`	`Subject[]`	Yes	Classificações de disciplinas relevantes.
`units`	`UnitReference[]`	Yes	Unidades de aprendizagem associadas.
`updatedAt`	`date-time`	Yes	Carimbo temporal da última atualização (não pode mudar em pequenas edições).

Registos da unidade

Cada registo de unidade terá o seguinte formulário:

{ 
"type": "unit",
  "id": "learn.wwl.fundamentals-generative-ai.agents",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/7-agents/",
  "locale": "en-us",
  "title": "AI agents",
  "durationInMinutes": 5,
  "updatedAt": "2025-10-06T17:09:00.0000000Z"
},

Detalhes do imóvel

Propriedade	Tipo	Obrigatório	Description
`type`	`enum`	Yes	Discriminador de tipo. Permitido: `unit`.
`id`	`string`	Yes	Identificador único para esta unidade em toda a Microsoft Learn.
`url`	`uri`	Yes	URL completamente qualificada para a unidade no local solicitado.
`locale`	`string`	Yes	Localização da unidade; Volta para `en-us` se o local solicitado não estiver disponível.
`title`	`string`	Yes	Título de unidade localizado (alternativa: Inglês dos EUA).
`durationInMinutes`	`integer`	Yes	Tempo médio de conclusão em minutos.
`updatedAt`	`date-time`	Yes	Última atualização do timestamp; pode permanecer inalterado para pequenas edições.

Registos do percurso de aprendizagem

Cada registo de percurso de aprendizagem terá o seguinte formulário:

{
  "type": "learningPath",
  "id": "learn.introduction-ai-azure",
  "url": "https://learn.microsoft.com/training/paths/introduction-to-ai-on-azure/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "durationInMinutes": 669,
  "summary": "This course introduces core concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions, focusing on Microsoft Foundry.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/document-intelligence-knowledge-mining.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "modules": [
    {
      "id": "learn.wwl.get-started-ai-fundamentals"
    },
    {
      "id": "learn.wwl.get-started-ai-in-foundry"
    },
    {
      "id": "learn.wwl.fundamentals-machine-learning"
    },
    {
      "id": "learn.wwl.design-machine-learning-model-training-solution"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai"
    },
    {
      "id": "learn.wwl.get-started-generative-ai-azure"
    },
    {
      "id": "learn.wwl.introduction-language"
    },
    {
      "id": "learn.wwl.get-started-language-azure"
    },
    {
      "id": "learn.wwl.introduction-ai-speech"
    },
    {
      "id": "learn.wwl.recognize-synthesize-speech"
    },
    {
      "id": "learn.wwl.introduction-computer-vision"
    },
    {
      "id": "learn.wwl.get-started-computer-vision"
    },
    {
      "id": "learn.wwl.introduction-information-extraction"
    },
    {
      "id": "learn.wwl.ai-information-extraction"
    }
  ],
  "updatedAt": "2025-12-12T00:08:00.0000000Z"
}

Detalhes do imóvel

Propriedade	Tipo	Obrigatório	Description
`type`	`enum`	Yes	Discriminador de tipo. Permitido: `learningPath`.
`id`	`string`	Yes	Identificador único para este percurso de aprendizagem em todo o Microsoft Learn.
`url`	`uri`	Yes	URL totalmente qualificado para o percurso de aprendizagem na localização solicitada.
`locale`	`string`	Yes	Locale em que o percurso de aprendizagem está escrito; recai para `en-us` caso o idioma solicitado não esteja disponível.
`title`	`string`	Yes	Título do percurso de aprendizagem localizado.
`durationInMinutes`	`integer`	Yes	Tempo médio de conclusão do percurso de aprendizagem em minutos.
`summary`	`string`	Yes	Breve descrição do percurso de aprendizagem.
`iconUrl`	`uri`	Yes	URL para um ícone SVG 100×100 que representa o caminho de aprendizagem.
`levels`	`Level[]`	Yes	Níveis de experiência associados ao percurso de aprendizagem.
`roles`	`Role[]`	Yes	Funções relevantes.
`products`	`Product[]`	Yes	Classificações de produtos relevantes.
`subjects`	`Subject[]`	Yes	Classificações de disciplinas relevantes.
`modules`	`ModuleReference[]`	Yes	Referências de módulos associadas.
`updatedAt`	`date-time`	Yes	Último carimbo de tempo atualizado; pode permanecer inalterado para pequenas edições.

Registos de Competências Aplicadas

Cada registo de Competências Aplicadas terá o seguinte formulário:

{
  "type": "appliedSkills",
  "id": "applied-skill.deploy-and-configure-azure-monitor",
  "locale": "en-us",
  "title": "Microsoft Applied Skills: 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",
  "iconUrl": "https://learn.microsoft.com/",
  "url": "https://learn.microsoft.com/credentials/applied-skills/deploy-and-configure-azure-monitor/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "administrator",
      "name": "Administrator"
    }
  ],
  "products": [
    {
      "id": "azure-monitor",
      "name": "Azure Monitor"
    },
    {
      "id": "azure-virtual-machines",
      "name": "Azure Virtual Machines"
    },
    {
      "id": "azure-virtual-network",
      "name": "Azure Virtual Network"
    },
    {
      "id": "windows-server",
      "name": "Windows Server"
    }
  ],
  "subjects": [
    {
      "id": "it-management-monitoring",
      "name": "IT management and monitoring"
    }
  ],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Detalhes do imóvel

Propriedade	Tipo	Obrigatório	Description
`type`	`enum`	Yes	Discriminador de tipo. Permitido: `appliedSkills`.
`id`	`string`	Yes	Identificador único para esta competência aplicada em todo o Microsoft Learn.
`locale`	`string`	Yes	Local onde a competência aplicada é escrita; Volta para `en-us` se o local solicitado não estiver disponível.
`title`	`string`	Yes	Título de competência aplicada localizada.
`summary`	`string`	Yes	Breve descrição da competência aplicada.
`iconUrl`	`uri`	Yes	URL para um ícone SVG 100×100 que representa a competência aplicada.
`url`	`uri`	Yes	URL totalmente qualificado para a competência aplicada na localização solicitada.
`levels`	`Level[]`	Yes	Níveis de experiência associados a esta habilidade aplicada.
`roles`	`Role[]`	Yes	Funções relevantes.
`products`	`Product[]`	Yes	Classificações de produtos relevantes.
`subjects`	`Subject[]`	Yes	Classificações de disciplinas relevantes.
`updatedAt`	`date-time`	Yes	Última atualização do carimbo temporal; pode permanecer inalterado para atualizações menores.

Registos de certificação

Cada registo de certificação terá o seguinte formulário:

{
  "type": "certification",
  "id": "certification.d365-functional-consultant-customer-service",
  "locale": "en-us",
  "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate (Legacy with Power Platform)",
  "subtitle": "<p>If you’re a functional consultant responsible for configuring and implementing Dynamics 365 solutions for customers, you can use this certification to shine a light on your skills and to help advance your career. A Dynamics 365 Customer Service functional consultant implements omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction. As a functional consultant, you know how to work with project managers, developers, and solution architects. You need a minimum of one to three years of experience as a functional consultant implementing Dynamics 365.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Work as a Dynamics 365 functional consultant on one or more projects.</li>\n<li>Work on a Dynamics 365 Customer Service implementation.</li>\n<li>Join the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>.</li>\n<li>Take available learning paths on <a href=\"/training/browse/?expanded=dynamics-365&amp;products=dynamics-customer-service&amp;roles=functional-consultant&amp;resource_type=learning%20path\">Microsoft Learn</a>.</li>\n<li>Complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course.</li>\n</ul>\n<div class=\"WARNING\">\n<p>Warning</p>\n<p>This version of the certification is no longer available. <a href=\"https://techcommunity.microsoft.com/t5/microsoft-learn-blog/new-exam-structure-for-dynamics-365-certifications-for-customer/ba-p/3500861\">Read this blog post for more information about this change</a>.</p>\n</div>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/d365-functional-consultant-customer-service-legacy-with-power-platform/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-analyst",
      "name": "Business Analyst"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "functional-consultant",
      "name": "Functional Consultant"
    }
  ],
  "products": [
    {
      "id": "power-apps",
      "name": "Power Apps"
    },
    {
      "id": "power-bi",
      "name": "Power BI"
    },
    {
      "id": "power-automate",
      "name": "Power Automate"
    },
    {
      "id": "dataverse",
      "name": "Microsoft Dataverse"
    },
    {
      "id": "ai-builder",
      "name": "AI Builder"
    },
    {
      "id": "power-platform",
      "name": "Microsoft Power Platform"
    },
    {
      "id": "office-teams",
      "name": "Microsoft Teams"
    },
    {
      "id": "microsoft-copilot-studio",
      "name": "Microsoft Copilot Studio"
    },
    {
      "id": "dynamics-365",
      "name": "Dynamics 365"
    },
    {
      "id": "dynamics-customer-service",
      "name": "Customer Service"
    }
  ],
  "subjects": [],
  "certificationType": {
    "id": "role-based",
    "name": "role-based"
  },
  "renewalFrequencyInDays": 0,
  "prerequisites": [],
  "exams": [
    {
      "id": "exam.mb-230"
    }
  ],
  "updatedAt": "2024-10-08T15:40:00.0000000Z"
}

Detalhes do imóvel

Propriedade	Tipo	Obrigatório	Description
`type`	`enum`	Yes	Discriminador de tipo. Permitido: `certification`.
`id`	`string`	Yes	Identificador único para esta certificação em toda a Microsoft Learn.
`locale`	`string`	Yes	Localização da certificação; retorna a `en-us` se o locale solicitado não estiver disponível.
`title`	`string`	Yes	Título de certificação localizado.
`subtitle`	`string`	Yes	Legenda de certificação localizada.
`iconUrl`	`uri`	Yes	URL para um ícone SVG 100×100 que representa a certificação.
`url`	`uri`	Yes	URL totalmente qualificado para a certificação na localização solicitada.
`levels`	`Level[]`	Yes	Níveis de experiência associados a esta certificação.
`roles`	`Role[]`	Yes	Funções relevantes.
`products`	`Product[]`	Yes	Classificações de produtos relevantes.
`subjects`	`Subject[]`	Yes	Classificações de disciplinas relevantes.
`certificationType`	`Taxonomy`	Yes	Classificação que representa o tipo de certificação.
`renewalFrequencyInDays`	`integer`	Yes	Número de dias antes de esta certificação expirar; `0` significa que não expira.
`prerequisites`	`string[]`	Yes	Lista de pré-requisitos recomendados para obter esta certificação.
`exams`	`ExamReference[]`	Yes	Exames associados são exigidos para esta certificação.
`updatedAt`	`date-time`	Yes	Carimbo temporal da última atualização; pode permanecer inalterado para pequenas edições.

Registos de exames

Cada registo de exame terá o seguinte formulário:

{
  "type": "exam",
  "id": "exam.77-881",
  "locale": "en-us",
  "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.",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/exams/77-881/",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-user",
      "name": "Business User"
    }
  ],
  "products": [
    {
      "id": "office-word",
      "name": "Word"
    }
  ],
  "locales": [],
  "examNumber": "77-881",
  "pdfUrl": "https://learn.microsoft.comhttps//query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
  "practiceAssessmentUrl": "https://learn.microsoft.com/",
  "providers": [],
  "courses": [],
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Detalhes do imóvel

Propriedade	Tipo	Obrigatório	Description
`type`	`enum`	Yes	Discriminador de tipo. Permitido: `exam`.
`id`	`string`	Yes	Identificador único para este exame no Microsoft Learn.
`locale`	`string`	Yes	Local onde o exame é escrito; Volta para `en-us` se o local solicitado não estiver disponível.
`title`	`string`	Yes	Título de exame localizado.
`subtitle`	`string`	Yes	Subtítulo adaptado do exame.
`iconUrl`	`uri`	Yes	URL para um ícone SVG 100×100 que representa o exame.
`url`	`uri`	Yes	URL totalmente qualificado para o exame no local solicitado.
`levels`	`Level[]`	Yes	Níveis de experiência associados a este exame.
`roles`	`Role[]`	Yes	Funções relevantes.
`products`	`Product[]`	Yes	Classificações de produtos relevantes.
`locales`	`Locale[]`	Yes	Línguas em que o exame é oficialmente oferecido.
`examNumber`	`string`	Yes	Número de identificação do exame
`pdfUrl`	`uri`	Não	URL para o PDF "Skills Measured" (Competências Avaliadas) deste exame.
`practiceAssessmentUrl`	`uri`	Não	URL para uma avaliação prática gratuita deste exame.
`providers`	`Provider[]`	Não	Prestadores que oferecem este exame.
`courses`	`Course[]`	Não	Cursos orientados por instrutores associados a este exame.
`studyGuide`	`StudyGuideRef[]`	Não	Conteúdo associado ao guia de estudo (referências polimórficas).
`updatedAt`	`date-time`	Yes	Último carimbo de tempo atualizado; pode permanecer inalterado para pequenas edições.

Registos de cursos ministrados por instrutores

Cada registo do curso terá o seguinte formulário:

{
  "type": "course",
  "id": "course.ai-900t00",
  "url": "https://learn.microsoft.com/training/courses/ai-900t00/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "summary": "<p>This course introduces fundamentals concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions. The course is not designed to teach students to become professional data scientists or software developers, but rather to build awareness of common AI workloads and the ability to identify Azure services to support them. The course is designed as a blended learning experience that combines instructor-led training with online materials on the Microsoft Learn platform (<a href=\"https://azure.com/learn\">https://azure.com/learn</a>). The hands-on exercises in the course are based on Learn modules, and students are encouraged to use the content on Learn as reference materials to reinforce what they learn in the class and to explore topics in more depth.</p>\n<h4 id=\"audience-profile\">Audience Profile</h4>\n<p>The Introduction to AI in Azure course is designed for anyone interested in learning about the types of solution artificial intelligence (AI) makes possible, and the services on Microsoft Azure that you can use to create them. You don’t need to have any experience of using Microsoft Azure before taking this course, but a basic level of familiarity with computer technology and the Internet is assumed. Some of the concepts covered in the course require a basic understanding of mathematics, such as the ability to interpret charts. The course includes hands-on activities that involve working with data and running code, so a knowledge of fundamental programming principles will be helpful.</p>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/course.svg",
  "courseNumber": "AI-900T00",
  "durationInHours": 24,
  "locales": [
    {
      "id": "en",
      "name": "en"
    },
    {
      "id": "ar",
      "name": "ar"
    },
    {
      "id": "zh-cn",
      "name": "zh-cn"
    },
    {
      "id": "zh-tw",
      "name": "zh-tw"
    },
    {
      "id": "fr",
      "name": "fr"
    },
    {
      "id": "de",
      "name": "de"
    },
    {
      "id": "id",
      "name": "id"
    },
    {
      "id": "it",
      "name": "it"
    },
    {
      "id": "ja",
      "name": "ja"
    },
    {
      "id": "ko",
      "name": "ko"
    },
    {
      "id": "pt-br",
      "name": "pt-br"
    },
    {
      "id": "ru",
      "name": "ru"
    },
    {
      "id": "es",
      "name": "es"
    }
  ],
  "levels": [],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    }
  ],
  "products": [
    {
      "id": "azure",
      "name": "Azure"
    }
  ],
  "certification": {
    "id": "certification.azure-ai-fundamentals"
  },
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
},

Detalhes do imóvel

Propriedade	Tipo	Obrigatório	Description
`type`	`enum`	Yes	Discriminador de tipo. Permitido: `course`.
`id`	`string`	Yes	Identificador único para este curso em todo o Microsoft Learn.
`url`	`uri`	Yes	URL totalmente qualificado para o curso na localização solicitada.
`locale`	`string`	Yes	Local onde o curso está escrito; Volta para `en-us` se o local solicitado não estiver disponível.
`title`	`string`	Yes	Título do curso localizado
`summary`	`string`	Yes	Breve descrição do curso.
`iconUrl`	`uri`	Yes	URL para um ícone SVG 100×100 que representa o percurso.
`courseNumber`	`string`	Yes	Número do curso liderado pelo instrutor.
`durationInHours`	`integer`	Yes	Tempo médio para completar o curso (em horas).
`locales`	`Locale[]`	Yes	Línguas em que o curso é oficialmente oferecido; outras línguas podem ser suportadas por parceiros.
`levels`	`Level[]`	Yes	Níveis de experiência associados a este curso.
`roles`	`Role[]`	Yes	Funções relevantes.
`products`	`Product[]`	Yes	Classificações de produtos relevantes.
`exam`	`ExamRef`	Não	Exame associado a este curso.
`certification`	`CertRef`	Não	Certificação associada a este curso.
`studyGuide`	`StudyGuideRef[]`	Não	Materiais de estudo relacionados (referências polimórficas).
`updatedAt`	`date-time`	Yes	Última atualização do carimbo temporal; pode permanecer inalterado para atualizações menores.

Registos de nível, produto, função e assunto

As coleções levels, products, roles, e subjects fornecem nomes amigáveis para os valores usados nos dados do módulo e do percurso de aprendizagem. Todas as quatro coleções têm a mesma forma:

{ 
    "id": "unique-id",
    "name": "name-of-item",
    "children": [
        { "id": "unique-id", "name": "name-of-item" },
        { "id": "unique-id", "name": "name-of-item" },
           ...
    ]
}

O id corresponderá aos valores para níveis, produtos, funções e temas incluídos nas outras entradas do catálogo. O nome associado name fornece um nome próprio em inglês para a entrada. O children array é opcional e permite organizar hierarquicamente valores que têm relações de dependência, como produtos.

Como exemplo, aqui está um conjunto de possíveis papéis:

{
    ...
    "roles": [ 
        {
            "id": "administrator",
            "name": "Administrator"
        },
        {
            "id": "ai-engineer",
            "name": "AI Engineer"
        },
        {
            "id": "business-analyst",
            "name": "Business Analyst"
        },
        {
            "id": "developer",
            "name": "Developer"
        },
        ...
    ]
}

Aqui está um conjunto de exemplos de produtos, com crianças incluídas para fornecer uma categoria de produto mais específica.

{ 
    ...
    "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"
        },
        ...
    ]
}

Próximos passos

Consulte os recursos abaixo para o ajudar na sua jornada de desenvolvimento:

Last updated on 2026-02-11

Partilhar via

Aprenda a documentação de referência para desenvolvedores da API Platform

Pontos de extremidade da API

Casos de uso

Authentication

Acesso somente ao aplicativo

Acesso delegado

Parâmetros de consulta

Resposta da API

Corpo da resposta

Resposta do módulo

Detalhes do imóvel

Registos da unidade

Detalhes do imóvel

Registos do percurso de aprendizagem

Detalhes do imóvel

Registos de Competências Aplicadas

Detalhes do imóvel

Registos de certificação

Detalhes do imóvel

Registos de exames

Detalhes do imóvel

Registos de cursos ministrados por instrutores

Detalhes do imóvel

Registos de nível, produto, função e assunto

Próximos passos

Recursos adicionais