{ "opencollection": "1.0.0", "info": { "name": "VTex Anti-fraud Provider Account Session API", "version": "1.0" }, "items": [ { "info": { "name": "Session", "type": "folder" }, "items": [ { "info": { "name": "VTex Get session", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/sessions", "params": [ { "name": "items", "value": "", "type": "query", "description": "Items are the keys of the values you wish to get. They follow the format `namespace1.key1,namespace2.key2`.\n\r\n\rIf you wish to recover the data sent on [Create new session](https://developers.vtex.com/docs/api-reference/session-manager-api#post-/api/sessions), it should be `public.{key}`, replacing `{key}` with the name of the custom property you created. Following the example request presented in [Create new session](https://developers.vtex.com/docs/api-reference/session-manager-api#post-/api/sessions), it would be `public.variable1,public.variable2`.\n\r\n\rIf you want to retrieve all keys from Session Manager, you can use the wildcard operator (`*`) as a value for this query parameter." } ] }, "docs": "Retrieves information from a previously created sesssion.\n\r\n\r>⚠️ The Session Manager API uses the `vtex_session` and `vtex_segment` cookies to store the data required to identify the user and the session. These cookies are stored in the user's browser when the session is created and sent automatically in every request to that domain. You will have to reproduce that by sending these cookies as headers to Session Manager API in order for it to work outside of a browser environment." }, { "info": { "name": "VTex Create new session", "type": "http" }, "http": { "method": "POST", "url": "https://{providerApiEndpoint}/api/sessions", "body": { "type": "json", "data": "{}" } }, "docs": "Creates a new session and returns a session token and a segment token. Also stores `vtex_session` and `vtex_segment` cookies, with the same values returned in the response.\n\r\n\rAll parameters in the body that are not within the public namespace will be ignored. Query string items will automatically be added to the public namespace.\n\r\n\rNo authentication is required.\n\r\n\r>⚠️ The Session Manager API uses the `vtex_session` and `vtex_segment` cookies to store the data required to identify the user and" }, { "info": { "name": "VTex Edit session", "type": "http" }, "http": { "method": "PATCH", "url": "https://{providerApiEndpoint}/api/sessions", "body": { "type": "json", "data": "{}" } }, "docs": "Edits information from a previously created sesssion.\n\r\n\rThis endpoint works the same way as the [Create new session](https://developers.vtex.com/docs/api-reference/session-manager-api#post-/api/sessions) endpoint, but when the request is sent with a `vtex_session` and the `vtex_segment` cookies in the header, it retrieves the session first and then applies the changes instead of generating a new one.\n\r\n\rOnly keys inside the `public` namespace in the request body are considered, and query parame" } ] } ], "bundled": true }