> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/back-office-api-reference/display-bo-api/slot-management.md).
# Slot Management
## Retrieve Slot List
> \## Function Description\
> \* Retrieves the full slot list.\
> \---\
> \## Detailed Description\
> \* \[BO] Display > Display Linking Management > Slot Management > Slot List grid area\
> \* Retrieves the slot list according to the inquiry conditions.\
> \---\
> \## Revision History\
> \* \`\`\`Release v1.05\_231204\`\`\` : Initial development of Slot Management\
> \* \`\`\`Release\`\`\` : Added a 1:N slot-to-mall concept via the slot-site-mall mapping table
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PrDispAdutInfo":{"type":"object","description":"Slot Management","properties":{"siteNo":{"type":"string","description":"Site No."},"adutId":{"type":"string","description":"Slot ID"},"adutNm":{"type":"string","description":"Slot Name"},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"dpmlNoList":{"type":"array","description":"Mall No. List","items":{"type":"string"}},"dpmlNm":{"type":"string","description":"Display Mall Name"},"tmplConrNo":{"type":"string","description":"Template Corner No."},"conrNo":{"type":"string","description":"Corner No."},"conrNm":{"type":"string","description":"Corner Name"},"shopNo":{"type":"string","description":"Store No."},"dispShopNm":{"type":"string","description":"Display Store Name"},"dispMediaCd":{"type":"string","description":"Display Media Code (DP018)"},"dispMediaNm":{"type":"string","description":"Display Media Code Name (DP018)"},"mappTtl":{"type":"string","description":"Mapping Title"},"useYn":{"type":"string","description":"Usage Status"},"templCornerDispYn":{"type":"string","description":"Template Corner Display Status"},"shopDispYn":{"type":"string","description":"Store Display Status"},"updateFlag":{"type":"string","description":"Edit Status"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account":{"get":{"tags":["Slot Management"],"summary":"Retrieve Slot List","description":"## Function Description\n* Retrieves the full slot list.\n---\n## Detailed Description\n* [BO] Display > Display Linking Management > Slot Management > Slot List grid area\n* Retrieves the slot list according to the inquiry conditions.\n---\n## Revision History\n* ```Release v1.05_231204``` : Initial development of Slot Management\n* ```Release``` : Added a 1:N slot-to-mall concept via the slot-site-mall mapping table\n","operationId":"getAccountList","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string"}},{"name":"dpmlNo","in":"query","description":"Display Mall No.","schema":{"type":"string"}},{"name":"shopNo","in":"query","description":"Store No.","schema":{"type":"string"}},{"name":"useYn","in":"query","description":"Usage Status","schema":{"type":"string"}},{"name":"adutInfo","in":"query","description":"Slot Type Information","schema":{"type":"string"}},{"name":"adutInfoVal","in":"query","description":"Slot Type Value","schema":{"type":"string"}},{"name":"dispConrInfo","in":"query","description":"Display Corner Type Information","schema":{"type":"string"}},{"name":"dispConrInfoVal","in":"query","description":"Display Corner Value","schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"number"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"number"}}],"responses":{"200":{"description":"Slot List Inquiry Successful","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrDispAdutInfo"}}}},"900":{"description":"Slot List Inquiry Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## Register and Modify Slot Information
> \## Function Description\
> \* Registers and modifies slot information.\
> \---\
> \## Detailed Description\
> \* \[BO] Display > Display Linking Management > Slot Management > Slot Register/Modify popup\
> \* Input parameters (\_\_\*\_\_: required)\
> \- create: \_\_adutId \*, adutNm \*, siteNo \*, dpmlNoList \*, shopNo \*, tmplConrNo \*, useYn \*\_\_\
> \- update: \_\_adutId \*, useYn \*, dpmlNoList \*\_\_\
> \---\
> \## Revision History\
> \* \`\`\`Release v1.05\_231204\`\`\` : Initial development of Slot Management\
> \* \`\`\`Release\`\`\` : Added template corner number duplicate check and slot-site-mall mapping table save
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account":{"post":{"tags":["Slot Management"],"summary":"Register and Modify Slot Information","description":"## Function Description\n* Registers and modifies slot information.\n---\n## Detailed Description\n* [BO] Display > Display Linking Management > Slot Management > Slot Register/Modify popup\n* Input parameters (__*__: required)\n - create: __adutId *, adutNm *, siteNo *, dpmlNoList *, shopNo *, tmplConrNo *, useYn *__\n - update: __adutId *, useYn *, dpmlNoList *__\n---\n## Revision History\n* ```Release v1.05_231204``` : Initial development of Slot Management\n* ```Release``` : Added template corner number duplicate check and slot-site-mall mapping table save\n","operationId":"saveAccount","responses":{"200":{"description":"Slot Management Register/Modify Successful","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Slot Management Register/Modify Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## Slot Store Management Tree Call
> \## Function Description\
> \* API for calling the slot store list in tree format from Slot Store Management.\
> \---\
> \## Detailed Description\
> \* Access path: \[BO] Display -> Display Linking Management -> Slot Store Management\
> \
> \* Retrieves the slot store list in tree format on a dedicated Slot Store Management screen.\
> \---\
> \## Revision History\
> \* \`\`\`Release v1.05\_231204\`\`\` : Initial development of Slot Store Management
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/shop":{"get":{"tags":["Slot Management"],"summary":"Slot Store Management Tree Call","description":"## Function Description\n* API for calling the slot store list in tree format from Slot Store Management.\n---\n## Detailed Description\n* Access path: [BO] Display -> Display Linking Management -> Slot Store Management\n\n* Retrieves the slot store list in tree format on a dedicated Slot Store Management screen.\n---\n## Revision History\n* ```Release v1.05_231204``` : Initial development of Slot Store Management\n","operationId":"getAccountShopList","parameters":[{"name":"dispYn","in":"query","description":"Display Status","schema":{"type":"string"}}],"responses":{"200":{"description":"Slot Store Management Tree Call Successful","content":{"*/*":{"schema":{"type":"string"}}}},"400":{"description":"Slot Store Management Tree Call Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## Slot Store Management - Register/Modify Slot Store
> \## Function Description\
> \* API for registering and modifying slot store information in Slot Store Management.\
> \---\
> \## Detailed Description\
> \* Access path: \[BO] Display -> Display Linking Management -> Slot Store Management -> Add Slot Store\
> \
> \* Registration\
> \* Click Add Slot Store, enter the store information, and add the slot store.\
> \* Required information: Store Name, Store Description, Display Status\
> \* Modification\
> \* Select the store to modify, then modify the store information.\
> \* Required information: Store Name, Display Status\
> \---\
> \## Revision History\
> \* \`\`\`Release v1.05\_231204\`\`\` : Initial development of Slot Store Management
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PrDispShopBase":{"type":"object","description":"Display Store Basic","properties":{"shopNo":{"type":"string","description":"Store No."},"shopTypCd":{"type":"string","description":"Store Type Code (DP003)"},"dpmlNo":{"type":"string","description":"Display Mall No."},"dispShopNm":{"type":"string","description":"Display Store Name"},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"dispYn":{"type":"string","description":"Display Status"},"dispMediaCd":{"type":"string","description":"Display Media Code (DP018)"},"dispCtgNo":{"type":"string","description":"Display Category No."},"prtTypCd":{"type":"string","description":"Output Type Code (DP002)"},"linkUrlAddr":{"type":"string","description":"Linked URL","readOnly":true},"linkDispNo":{"type":"string","description":"Linked Display No.","readOnly":true},"movFrmeCd":{"type":"string","description":"Navigation Frame Code (DP007)","readOnly":true},"brandNo":{"type":"string","description":"Brand No."},"shopDescCont":{"type":"string","description":"Store Description Content"},"dispCtgNm":{"type":"string","description":"Display Category Name"},"brandNm":{"type":"string","description":"Brand Name","readOnly":true}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/shop":{"post":{"tags":["Slot Management"],"summary":"Slot Store Management - Register/Modify Slot Store","description":"## Function Description\n* API for registering and modifying slot store information in Slot Store Management.\n---\n## Detailed Description\n* Access path: [BO] Display -> Display Linking Management -> Slot Store Management -> Add Slot Store\n\n* Registration\n * Click Add Slot Store, enter the store information, and add the slot store.\n * Required information: Store Name, Store Description, Display Status\n* Modification\n * Select the store to modify, then modify the store information.\n * Required information: Store Name, Display Status\n---\n## Revision History\n* ```Release v1.05_231204``` : Initial development of Slot Store Management\n","operationId":"saveAccountShop","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrDispShopBase"}}},"required":true},"responses":{"200":{"description":"Slot Store Save Successful","content":{"*/*":{"schema":{"type":"string"}}}},"400":{"description":"Slot Store Save Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## Retrieve Slot Detail Information
> \## Function Description\
> \* Retrieves slot detail information.\
> \---\
> \## Detailed Description\
> \* \[BO] Display > Display Linking Management > Slot Management > Slot Register/Modify popup\
> \* Retrieves slot details according to the inquiry conditions.\
> \---\
> \## Revision History\
> \* \`\`\`Release\`\`\` : Initial development of the Slot Register/Modify popup
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PrDispAdutInfo":{"type":"object","description":"Slot Management","properties":{"siteNo":{"type":"string","description":"Site No."},"adutId":{"type":"string","description":"Slot ID"},"adutNm":{"type":"string","description":"Slot Name"},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"dpmlNoList":{"type":"array","description":"Mall No. List","items":{"type":"string"}},"dpmlNm":{"type":"string","description":"Display Mall Name"},"tmplConrNo":{"type":"string","description":"Template Corner No."},"conrNo":{"type":"string","description":"Corner No."},"conrNm":{"type":"string","description":"Corner Name"},"shopNo":{"type":"string","description":"Store No."},"dispShopNm":{"type":"string","description":"Display Store Name"},"dispMediaCd":{"type":"string","description":"Display Media Code (DP018)"},"dispMediaNm":{"type":"string","description":"Display Media Code Name (DP018)"},"mappTtl":{"type":"string","description":"Mapping Title"},"useYn":{"type":"string","description":"Usage Status"},"templCornerDispYn":{"type":"string","description":"Template Corner Display Status"},"shopDispYn":{"type":"string","description":"Store Display Status"},"updateFlag":{"type":"string","description":"Edit Status"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/{adutId}":{"get":{"tags":["Slot Management"],"summary":"Retrieve Slot Detail Information","description":"## Function Description\n* Retrieves slot detail information.\n---\n## Detailed Description\n* [BO] Display > Display Linking Management > Slot Management > Slot Register/Modify popup\n* Retrieves slot details according to the inquiry conditions.\n---\n## Revision History\n* ```Release``` : Initial development of the Slot Register/Modify popup\n","operationId":"getAccountDetail","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string"}},{"name":"adutId","in":"path","description":"Slot ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Slot Detail Inquiry Successful","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PrDispAdutInfo"}}}},"900":{"description":"Slot Detail Inquiry Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## Retrieve Template Corner Number List Linked to Slot
> \## Function Description\
> \* API for retrieving the template corner number list linked to a slot.\
> \---\
> \## Detailed Description\
> \* \[BO] Display > Display Linking Management > Slot Management by Service\
> \* Retrieves the template corner number list linked to a slot.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/display/account/tmplConrNo":{"get":{"tags":["Slot Management"],"summary":"Retrieve Template Corner Number List Linked to Slot","description":"## Function Description\n* API for retrieving the template corner number list linked to a slot.\n---\n## Detailed Description\n* [BO] Display > Display Linking Management > Slot Management by Service\n* Retrieves the template corner number list linked to a slot.\n","operationId":"getMappedTmplConrNoList","parameters":[{"name":"tmplConrNoList","in":"query","description":"Template Corner No. List","required":true,"schema":{"type":"array"}}],"responses":{"200":{"description":"Template Corner Number List Linked to Slot Inquiry Successful","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Template Corner Number List Linked to Slot Inquiry Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```