Tech-invite  3GPPspecsRELsGlossariesSIP
Info21222324252627282931323334353637384‑5x

full Contents for  TS 23.222  Word version:   17.0.0

Top   Up   Prev   Next
0…   4…   5   6…   6.3…   7…   8…   8.5…   8.9…   8.13…   8.17…   8.21…   8.25…   9…   10…   11…   A   B…   B.2   B.3   C…   D…

 

10  CAPIF core function APIs
10.1  General
Table 10.1-1 illustrates the CAPIF core function APIs.
API Name
API Operations
Known Consumer(s)
Communication Type

CAPIF_Discover_Service_API
Discover_Service_API
AP Invoker
Request/ Response
Subscribe_Event
API Invoker
Request/ Response
Notify_Event
API Invoker
Notify
Unsubscribe_Event
API Invoker
Request/ Response
CAPIF_Publish_Service_API
Publish_Service_API
API Publishing Function
Request/ Response
Unpublish_Service_API
API Publishing Function
Request/ Response
Update_Service_API
API Publishing Function
Request/ Response
Get_Service_API
API Publishing Function
Request/ Response
Subscribe_Event
API Publishing Function
Request/ Response
Notify_Event
API Publishing Function
Notify
Unsubscribe_Event
API Publishing Function
Request/ Response
CAPIF_Events API
Subscribe_Event
API Invoker, API Publishing Function, API Management Function, API Exposing Function
Request/ Response
Notify_Event
API Invoker, API Publishing Function, API Management Function, API Exposing Function
Notify
Unsubscribe_Event
API Invoker, API Publishing Function, API Management Function, API Exposing Function
Request/ Response
CAPIF_API_Invoker_management API
Onboard_API_Invoker
API Invoker
Request/ Response
Offboard_API_Invoker
API Invoker
Request/ Response
Subscribe_Event
API Management Function
Request/ Response
Notify_Event
API Management Function
Notify
Unsubscribe_Event
API Management Function
Request/ Response
CAPIF_Security API
Obtain_Security_Method
API Invoker
Request/ Response
Obtain_Authorization
API Invoker
Request/ Response
Obtain_API_Invoker_Info
API Exposing Function
Request/ Response
Revoke_Authorization
API Exposing Function
Request/ Response
CAPIF_Monitoring API
Subscribe_Event
API Management Function
Request/ Response
Notify_Monitoring_Service_Event
API Management Function
Notify
Unsubscribe_Event
API Management Function
Request/ Response
CAPIF_Logging_API_Invocation API
Log_API_Invocation
API exposing function
Request/ Response
CAPIF_Auditing API
Query_API_Invocation_Log
API management function
Request/ Response
CAPIF_Access_Control_Policy API
Obtain_Access_Control_Policy
API exposing function
Request/Response

Up
10.2  CAPIF_Discover_Service_API APIWord-p. 86
10.2.1  General
API description:
This API enables the API invoker to communicate with the CAPIF core function to discover the published service API information over CAPIF‑1 or CAPIF‑1e.
10.2.2  Discover_Service_API operation
API operation name:
Discover_Service_API
Description:
Provides the published service APIs information.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.7.3 for the details of usage of this API operation.
10.2.3  Subscribe_Event operationWord-p. 87
API operation name:
Subscribe_Event
Description:
Provides subscription to the CAPIF related event information.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.8.3 for the details of usage of this API operation.
10.2.4  Notify_Event operation
API operation name:
Notify_Event
Description:
Provides the relevant CAPIF event information to the subscribed entities.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.8.4 for the details of usage of this API operation.
10.2.5  Unsubscribe_Event operation
API operation name:
Unsubscribe_Event
Description:
Unsubscription to the CAPIF event information.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.8.5 for the details of usage of this API operation.
10.3  CAPIF_Publish_Service_API API
10.3.1  General
API description:
This API enables the API publishing function to communicate with the CAPIF core function to publish the service API information and manage the published service API information over CAPIF‑4.
NOTE:
Stage 3 can decide whether the API for CAPIF_Publish_Service_API can be enabled over CAPIF‑4.
10.3.2  Publish_Service_API operationWord-p. 88
API operation name:
Publish_Service_API
Description:
Publish the service API information.
Known Consumers:
API publishing function.
Inputs:
Outputs:
See subclause 8.3.3 for the details of usage of this API operation.
10.3.3  Unpublish_Service_API operation
API operation name:
Unpublish_Service_API
Description:
Remove the published service API information.
Known Consumers:
API publishing function.
Inputs:
Outputs:
See subclause 8.4.3 for the details of usage of this API operation.
10.3.4  Update_Service_API operation
API operation name:
Update_Service_API
Description:
Update the published service API information.
Known Consumers:
API publishing function.
Inputs:
Outputs:
See subclause 8.6.3 for the details of usage of this API operation.
10.3.5  Get_Service_API operation
API operation name:
Get_Service_API
Description:
Retrieve the published service API information.
Known Consumers:
API publishing function.
Inputs:
Outputs:
See subclause 8.12.3 for the details of usage of this API operation.
10.3.6  Subscribe_Event operation
API operation name:
Subscribe_Event
Description:
Provides subscription to the CAPIF related event information.
Known Consumers:
API publishing function.
Inputs:
Outputs:
See subclause 8.8.3 for the details of usage of this API operation.
10.3.7  Notify_Event operationWord-p. 89
API operation name:
Notify_Event
Description:
Provides the relevant CAPIF event information to the subscribed entities.
Known Consumers:
API publishing function.
Inputs:
Outputs:
See subclause 8.8.4 for the details of usage of this API operation.
10.3.8  Unsubscribe_Event operation
API operation name:
Unsubscribe_Event
Description:
Unsubscription to the CAPIF event information.
Known Consumers:
API publishing function.
Inputs:
Outputs:
See subclause 8.8.5 for the details of usage of this API operation.
10.4  CAPIF_Events API
10.4.1  General
API description: This API enables the API subscribing entity to communicate with the CAPIF core function to subscribe to and unsubscribe from CAPIF events and receive subsequent notification of CAPIF events. This API is used for the subscription to and notifications of those CAPIF events that are not bound to any of the other CAPIF core function APIs. The following are the key functionalities:
  • API invoker subscribes to CAPIF events over CAPIF‑1 or CAPIF‑1e.
  • API invoker receives notifications for subscribed CAPIF events over CAPIF‑1 or CAPIF‑1e.
  • API invoker unsubscribes from CAPIF events over CAPIF‑1 or CAPIF‑1e.
  • API exposing function subscribes to CAPIF events over CAPIF‑3.
  • API exposing function receives notifications for subscribed CAPIF events over CAPIF‑3.
  • API exposing function unsubscribes from CAPIF events over CAPIF‑3.
  • API publishing function subscribes to CAPIF events over CAPIF‑4.
  • API publishing function receives notifications for subscribed CAPIF events over CAPIF‑4.
  • API publishing function unsubscribes from CAPIF events over CAPIF‑4.
  • API management function subscribes to CAPIF events over CAPIF‑5.
  • API management function receives notifications for subscribed CAPIF events over CAPIF‑5.
  • API management function unsubscribes from CAPIF events over CAPIF‑5.
NOTE:
Stage 3 can further decide if CAPIF_Events API can be further fine grained into more APIs.
Up
10.4.2  Subscribe_Event operationWord-p. 90
API operation name:
Subscribe_Event
Description:
Provides subscription to the CAPIF related event information.
Known Consumers:
API invoker, API publishing function, API management function, API exposing function.
Inputs:
Outputs:
See subclause 8.8.3 for the details of usage of this API operation.
10.4.3  Notify_Event operation
API operation name:
Notify_Event
Description:
Provides the relevant CAPIF event information to the subscribed entities.
Known Consumers:
API invoker, API publishing function, API management function, API exposing function.
Inputs:
Outputs:
See subclause 8.8.4 for the details of usage of this API operation.
10.4.4  Unsubscribe_Event operation
API operation name:
Unsubscribe_Event
Description:
Unsubscription to the CAPIF event information.
Known Consumers:
API invoker, API publishing function, API management function, API exposing function.
Inputs:
Outputs:
See subclause 8.8.5 for the details of usage of this API operation.
10.5  CAPIF_API_invoker_management API
10.5.1  General
API description:
This API enables the API invoker to communicate with the CAPIF core function to enroll as a registered user of CAPIF and manage the enrollment information over CAPIF‑1 or CAPIF‑1e.
10.5.2  Onboard_API_Invoker operation
API operation name:
Onboard_API_Invoker
Description:
Enrolls the API invoker as a recognized user of the CAPIF.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.1.3 for the details of usage of this API operation.
10.5.3  Offboard_API_Invoker operationWord-p. 91
API operation name:
Offboard_API_Invoker
Description:
Cancels enrollment of the API invoker as a recognized user of the CAPIF.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.2.3 for the details of usage of this API operation.
10.5.4  Subscribe_Event operation
API operation name:
Subscribe_Event
Description:
Provides subscription to the CAPIF related event information.
Known Consumers:
API management function.
Inputs:
Outputs:
See subclause 8.8.3 for the details of usage of this API operation.
10.5.5  Notify_Event operation
API operation name:
Notify_Event
Description:
Provides the relevant CAPIF event information to the subscribed entities.
Known Consumers:
API management function.
Inputs:
Outputs:
See subclause 8.8.4 for the details of usage of this API operation.
10.5.6  Unsubscribe_Event operation
API operation name:
Unsubscribe_Event
Description:
Unsubscription to the CAPIF event information.
Known Consumers:
API management function.
Inputs:
Outputs:
See subclause 8.8.5 for the details of usage of this API operation.
10.6  CAPIF_Security APIWord-p. 92
10.6.1  General
API description:
This API enables the API invoker to communicate with the CAPIF core function to authenticate and obtain authorization to access service APIs over CAPIF‑1 or CAPIF‑1e.
10.6.2  Obtain_Security_Method operation
API operation name:
Obtain_Security_Method
Description:
Obtain information about service API security method with CAPIF core function for service API invocations.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.10.3 for the details of usage of this API operation.
10.6.3  Obtain_Authorization operation
API operation name:
Obtain_Authorization
Description:
Provides the authorization information to access relevant service API.
Known Consumers:
API invoker.
Inputs:
Outputs:
See subclause 8.16.3 for the details of usage of this API operation.
10.6.4  Obtain_API_Invoker_Info operation
API operation name:
Obtain_API_Invoker_Info
Description:
Obtains the API invoker information.
Known Consumers:
API exposing function.
Inputs:
Outputs:
See subclause 8.16.3 for the details of usage of this API operation.
10.6.5  Revoke_Authorization operation
API operation name:
Revoke_Authorization
Description:
Revokes API invoker authorization to access service API.
Known Consumers:
API exposing function.
Inputs:
Outputs:
See subclause 8.23.3 for the details of usage of this API operation.
10.7  CAPIF_Monitoring APIWord-p. 93
10.7.1  General
API description:
This API enables the API management function to communicate with the CAPIF core function to subscribe to and unsubscribe from CAPIF events related to monitoring and receive subsequent notification of CAPIF monitoring events over CAPIF‑5.
NOTE:
Stage 3 can decide whether the API for CAPIF_Monitoring can be enabled over CAPIF‑5.
10.7.2  Subscribe_Event operation
API operation name:
Subscribe_Event
Description:
Provides subscription to the CAPIF related event information.
Known Consumers:
API management function.
Inputs:
Outputs:
See subclause 8.8.3 for the details of usage of this API operation.
10.7.3  Notify_Monitoring_Service_Event operation
API operation name:
Notify_Monitoring_Service_Event
Description:
Provides the notification of the events related to monitoring service API invocations to the subscribed API management function.
Known Consumers:
API management function.
Inputs:
Outputs:
See subclause 8.21.3 for the details of usage of this API operation.
10.7.4  Unsubscribe_Event operation
API operation name:
Unsubscribe_Event
Description:
Unsubscription to the CAPIF event information.
Known Consumers:
API management function.
Inputs:
Outputs:
See subclause 8.8.5 for the details of usage of this API operation.
10.8  CAPIF_Logging_API_Invocation API
10.8.1  General
API description:
This API enables the API exposing function to communicate with the CAPIF core function to log the information related to service API invocation over CAPIF‑3.
NOTE:
Stage 3 can decide whether the API for CAPIF_Logging_API_Invocation can be enabled over CAPIF 3.
10.8.2  Log_API_Invocation operationWord-p. 94
API operation name:
Log_API_Invocation
Description:
Enables to log API invocation information.
Known Consumers:
API exposing function.
Inputs:
Outputs:
See subclause 8.19.3 for the details of usage of this API operation.
10.9  CAPIF_Auditing API
10.9.1  General
API description:
This API enables the API management function to communicate with the CAPIF core function to retrieve the log information related to service API invocation over CAPIF‑5.
NOTE:
Stage 3 can decide whether the API for CAPIF_Auditing can be enabled over CAPIF 5.
10.9.2  Query_ API_Invocation_Log operation
API operation name:
Query_API_Invocation_Log
Description:
Query the API invocation log information.
Known Consumers:
API management function.
Inputs:
Outputs:
See subclause 8.22.3 for the details of usage of this API operation.
10.10  CAPIF_Access_Control_Policy API
10.10.1  General
API description:
This API enables the API exposing function to obtain the policy to perform access control on the service API invocations.
10.10.2  Obtain_Access_Control_Policy operation
API operation name:
Obtain_Access_Control_Policy
Description:
Allows obtaining the policy to perform access control on the service API invocations.
Known Consumers:
API exposing function.
Inputs:
Outputs:
See subclause 8.12.3 for the details of usage of this API operation.

Up   Top   ToC