• Microsoft Learn(Use the Microsoft Graph API)
• Microsoft Learn(엑세스 토큰 발급 방안 - Client Credentials Type 사용)
• Microsoft Learn(OData Documentation)
• OData(Blog 1)
• OData(Blog 2)
• OData(Wiki)
• Microsoft Learn(OData Query Parameter)
• GraphQL(Kakao Tech Blog) (나중에 읽어보기!)

• 간단하고 표준적인 방식으로 쿼리 가능하고 상호 운용 가능한 REST API 를 만들고 사용할 수 있는 개방형 프로토콜 (CRUDQ (Create, Read, Update, Delete, Query) 작업 지원)
• 서비스 제공자 입장에서 웹으로 데이터를 제공하는 방식으로 오픈된 공통규약
• 웹 클라이언트가 간단한 HTTP 메시지를 사용 하여 쿼리문을 호출, 해당 URL을 식별하여 데이터 모델 에 정의된 리소스를 생성 및 수정 가능
• Microsoft 는 OData 를 2007년에 사용 시작

• Entity Data Model (EDM) 이란 OData 서비스에서 노출하는 데이터(리소스)를 설명하는데 사용되는 추상 데이터 모델
• OData 메타데이터 문서에는 클라이언트의 사용을 위해 노출된 서비스의 데이터 모델을나타낸다.

• Microsoft 클라우드 서비스 리소스에 접근할 수 있는 RESTful API
• Azure 에 앱을 등록 하고, 등록 된 앱에서 Client ID, Secret 확인 가능 (인증 Flow에 사용)
• App 관리자는 해당 앱에 대한 인증서, 범위, 사용자 할당 등의 상세 설정

• Import API from URL 방식으로 Create API (https://graph.microsoft.com/v1.0)
• Swagger UI 에서 호출 가능한지 테스트 필요 (API Portal Try-Out 가능한지)
• Policy 에서 Custom Extension 으로 Access Token 발급 & Set Header (Authorization)

• 참고 OData Parameter (V4 query language)
• [2-1] 하나의 파라미터로 받아 처리 (Description에 설명 추가)
• [2-2] 또는 Request Parameter 에 OData Parameter 설정이 가능한지 테스트 필요
• [2-3] In/Output (Required : true/false) 만 설정 하고 호출받은 Query 그대로 전달
• transportInfo 의 query는 인코딩 됨 (’&’) 방화벽 오픈 후 테스트 필요
• OData API 는 REST API 의 일부 = Swagger UI 에서 호출 가능
• REST API 로 생성 시 (CUDO Portal Try-out 문제 없음)

• 호출 Try-Out → Graph Explorer 참고
• 22/12/08 기준 SKBS 개발서버 I/F 캡처

• [POST]https://login.microsoftonline.com/{tenant ID}/oauth2/v2.0/token

## **호출 예시 ##**


[**POST]** <https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token> HTTP/1.1


## **Request Header ##**


**Host:** login.microsoftonline.com
**Content-Type:** application/x-www-form-urlencoded


## **Request Body ##**


**client_id**=535fb089-9ff3-47b6-9bfb-4f1264799865
&**scope**=https%3A%2F%2Fgraph.microsoft.com%2F.default
&**client_secre**t=qWgdYAmab0YSkuL1qKv5bPX
&**grant_type**=client_credentials

• Request Parameter
• $select (Optional) → Input/Output 에 Requred : False 설정
• Request Header
• Authorization : Bearer {access_token}
• Response
• 200 OK + Response body
• 202 Accepted → 성공적으로 처리되었지만 서버가 관련된 백그라운드 작업을 완료하는 데 더 많은 시간이 필요할 때 반환

• Request Parameter (OData V.4 Query Parameter)
  → $value url 파라미터 제외 나머지 OData Paramter Required : False 설정
  [파라미터 상세]
• System query options

• Other query parameters

• Other Odata URL capabilities

• Request Header
• Authorization : Bearer {access_token}
• Response
• 200 OK
• 404 Not found

• Request Parameter
• MSC_IF0002 와 동일
• Request Header
• Authorization : Bearer {access_token}
• (Prefer) outlook.body-content-type
• 반환할 본문 및 uniqueBody 속성의 형식, 값은 "text" 또는 "html", 헤더를 지정하지 않으면 body 및 uniqueBody 속성이 HTML (Default), (Optional 헤더)
• Response
• 200 OK → Message 객체 컬렉션 반환

• Request Parameter
• MSC_IF0002 와 동일

1. The n value of $levels can be max (to return all managers) or a number between 1 and 1000.
2. When the $levels parameter is not specified, only the immediate manager is returned.
3. You can specify $select inside $expand to select the individual manager's properties. The $levels parameter is required: $expand=manager($levels=max;$select=id,displayName).
4. $levels parameter is only supported on a single user (/users/{id} or me endpoints) and not on the entire list of users.
5. $levels requires the ConsistencyLevel header set to eventual and $count=true in query string. For more information about the use of ConsistencyLevel and $count, see Advanced query capabilities on Azure AD directory objects.

• Request Header
• Authorization : Bearer {access_token}
• 🔔**(eventual)** ConsistencyLevel : $count=true 쿼리 문자열이 포함된 경우 필요
• Response
• 200 OK → directoryObject 개체 반환

• Request Parameter
• MSC_IF0002 와 동일
• Request Header
• ❓ Authorization : Bearer {access_token}
• (Optional) if-none-match [etag] (테스트 필요)
• Response
• 200 OK