From 3ca8cd5b567836b9d22aa34984ade81ebd04b30b Mon Sep 17 00:00:00 2001
From: Jorge Moratinos Salcines <jorge.moratinossalcines@telefonica.com>
Date: Thu, 23 Jan 2025 12:13:58 +0100
Subject: [PATCH] Copied information for ppt presented on TECH meeting

---
 doc/vendor-ext/vendor-ext.md | 61 +++++++++++++++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/doc/vendor-ext/vendor-ext.md b/doc/vendor-ext/vendor-ext.md
index 2e3822a..db85cc3 100644
--- a/doc/vendor-ext/vendor-ext.md
+++ b/doc/vendor-ext/vendor-ext.md
@@ -1,6 +1,65 @@
 # Vendor Extensibility
+This is a mechanism for the APIs to re-use, extend their functionalities and data models and engage with third-party API frameworks. 
 
-DOC:Work in Progress
+Is defined on 3GPP TS 29.122 and 29.500 and is tightly connected with “supported-features” and feature negotiation
+
+## Supported Features in Publish API:
+![Publish Supported Features](../images/vendor-ext/publish_supported_features.png)
+
+## Types of vendor extensions
+
+**Data models**
+
+* Extend the information element with vendor specific fields
+### Fields have specific naming schemes:
+* Using the 6-digit IANA-assigned enterprise code:
+
+
+
+```
+  "vendorSpecific-010415": {
+        ...
+        }
+```
+
+* Using domain name:
+
+
+```
+"vendorSpecific-3gpp.org": {
+        ...
+        }
+```
+
+* Using URN:
+
+
+```
+"vendorSpecific-urn:3gpp:example": {
+        ...
+        }
+```
+
+## Discover Query Parameters
+
+* Provisioning of vendor-specific query parameters to support additional vendor-specific filtering criteria
+### A vendor-specific query parameter shall be encoded as follows:
+    
+* query parameter name: 
+
+
+```
+"vend-spec-<query parameter name>”
+```
+
+* query parameter value encoded as JSON object:
+    * "target" 
+    * "value"
+
+**Example:**
+```
+GET {apiRoot}/3gpp-monitoring-event/v1/{scsAsId}/subscriptions?vend-spec-max-reports={"target": "/maximumNumberOfReports", value: "6"} 
+```
 
 
 [OCF Web]: https://ocf.etsi.org/ "OCF Web"
-- 
GitLab