{
    "info": {
        "description": "Deep link endpoints for map tours and vendor booths in an org.",
        "title": "Talque Map Deep Link",
        "version": "1.0.0"
    },
    "paths": {
        "/go/org/{org_id}/map/{map_layer_id}/tour/{map_tour_id}/{action}": {
            "get": {
                "summary": "Open a map tour via deep link (redirect)",
                "description": "Generates a deep link that opens a specific map tour in an organization.\n\n`GET` redirects the browser to the frontend deep-link handler URL.\n\n`POST` returns the parsed hyperlink as JSON so the frontend can\nprogrammatically inspect the destination without following a redirect.\n",
                "parameters": [
                    {
                        "name": "org_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Organization ID."
                    },
                    {
                        "name": "map_layer_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map layer ID."
                    },
                    {
                        "name": "map_tour_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map tour ID."
                    },
                    {
                        "name": "action",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "view"
                            ]
                        },
                        "description": "Action to perform."
                    }
                ],
                "responses": {
                    "302": {
                        "description": "Redirect to the frontend deep-link handler URL.",
                        "headers": {
                            "Location": {
                                "schema": {
                                    "type": "string"
                                },
                                "description": "Frontend URL containing the encoded hyperlink token."
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request \u2014 an ID could not be parsed."
                    },
                    "404": {
                        "description": "Organization not found."
                    }
                }
            },
            "post": {
                "summary": "Open a map tour via deep link (JSON)",
                "description": "Same as GET but returns the hyperlink as JSON instead of redirecting.",
                "parameters": [
                    {
                        "name": "org_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Organization ID."
                    },
                    {
                        "name": "map_layer_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map layer ID."
                    },
                    {
                        "name": "map_tour_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map tour ID."
                    },
                    {
                        "name": "action",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "view"
                            ]
                        },
                        "description": "Action to perform."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Parsed hyperlink token.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "hyperlink": {
                                            "type": "string",
                                            "description": "JWT-encoded hyperlink token."
                                        },
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "reason": {
                                            "type": "string"
                                        },
                                        "reasonEnum": {
                                            "type": "string"
                                        }
                                    },
                                    "required": [
                                        "hyperlink",
                                        "success",
                                        "reason",
                                        "reasonEnum"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request \u2014 an ID could not be parsed."
                    },
                    "404": {
                        "description": "Organization not found."
                    }
                }
            }
        },
        "/go/org/{org_id}/map/{map_layer_id}/partner/{vendor_id}/{action}": {
            "get": {
                "summary": "Open a vendor booth on the map via deep link (redirect)",
                "description": "Generates a deep link that opens a vendor booth on the map in an organization.\n\nThe vendor is resolved by internal VendorIdentifier first; if not found,\nan external ID lookup is performed as a fallback.\n\n`GET` redirects the browser to the frontend deep-link handler URL.\n\n`POST` returns the parsed hyperlink as JSON so the frontend can\nprogrammatically inspect the destination without following a redirect.\n",
                "parameters": [
                    {
                        "name": "org_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Organization ID."
                    },
                    {
                        "name": "map_layer_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map layer ID."
                    },
                    {
                        "name": "vendor_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "VendorIdentifier or external vendor ID."
                    },
                    {
                        "name": "action",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "view"
                            ]
                        },
                        "description": "Action to perform."
                    }
                ],
                "responses": {
                    "302": {
                        "description": "Redirect to the frontend deep-link handler URL.",
                        "headers": {
                            "Location": {
                                "schema": {
                                    "type": "string"
                                },
                                "description": "Frontend URL containing the encoded hyperlink token."
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request \u2014 an ID could not be parsed."
                    },
                    "404": {
                        "description": "Organization not found."
                    }
                }
            },
            "post": {
                "summary": "Open a vendor booth on the map via deep link (JSON)",
                "description": "Same as GET but returns the hyperlink as JSON instead of redirecting.",
                "parameters": [
                    {
                        "name": "org_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Organization ID."
                    },
                    {
                        "name": "map_layer_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map layer ID."
                    },
                    {
                        "name": "vendor_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "VendorIdentifier or external vendor ID."
                    },
                    {
                        "name": "action",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "view"
                            ]
                        },
                        "description": "Action to perform."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Parsed hyperlink token.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "hyperlink": {
                                            "type": "string",
                                            "description": "JWT-encoded hyperlink token."
                                        },
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "reason": {
                                            "type": "string"
                                        },
                                        "reasonEnum": {
                                            "type": "string"
                                        }
                                    },
                                    "required": [
                                        "hyperlink",
                                        "success",
                                        "reason",
                                        "reasonEnum"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request \u2014 an ID could not be parsed."
                    },
                    "404": {
                        "description": "Organization not found."
                    }
                }
            }
        },
        "/go/org/{org_id}/map/{map_layer_id}/partner/{vendor_id}/booth/{map_feature_id}/{action}": {
            "get": {
                "summary": "Open a specific map feature for a vendor via deep link (redirect)",
                "description": "Generates a deep link that opens a specific map feature for a vendor in an organization.\n\n`GET` redirects the browser to the frontend deep-link handler URL.\n\n`POST` returns the parsed hyperlink as JSON so the frontend can\nprogrammatically inspect the destination without following a redirect.\n",
                "parameters": [
                    {
                        "name": "org_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Organization ID."
                    },
                    {
                        "name": "map_layer_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map layer ID."
                    },
                    {
                        "name": "vendor_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "VendorIdentifier or external vendor ID."
                    },
                    {
                        "name": "map_feature_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map feature ID."
                    },
                    {
                        "name": "action",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "view"
                            ]
                        },
                        "description": "Action to perform."
                    }
                ],
                "responses": {
                    "302": {
                        "description": "Redirect to the frontend deep-link handler URL.",
                        "headers": {
                            "Location": {
                                "schema": {
                                    "type": "string"
                                },
                                "description": "Frontend URL containing the encoded hyperlink token."
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request \u2014 an ID could not be parsed."
                    },
                    "404": {
                        "description": "Organization not found."
                    }
                }
            },
            "post": {
                "summary": "Open a specific map feature for a vendor via deep link (JSON)",
                "description": "Same as GET but returns the hyperlink as JSON instead of redirecting.",
                "parameters": [
                    {
                        "name": "org_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Organization ID."
                    },
                    {
                        "name": "map_layer_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map layer ID."
                    },
                    {
                        "name": "vendor_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "VendorIdentifier or external vendor ID."
                    },
                    {
                        "name": "map_feature_id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Map feature ID."
                    },
                    {
                        "name": "action",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "view"
                            ]
                        },
                        "description": "Action to perform."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Parsed hyperlink token.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "hyperlink": {
                                            "type": "string",
                                            "description": "JWT-encoded hyperlink token."
                                        },
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "reason": {
                                            "type": "string"
                                        },
                                        "reasonEnum": {
                                            "type": "string"
                                        }
                                    },
                                    "required": [
                                        "hyperlink",
                                        "success",
                                        "reason",
                                        "reasonEnum"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad request \u2014 an ID could not be parsed."
                    },
                    "404": {
                        "description": "Organization not found."
                    }
                }
            }
        }
    },
    "openapi": "3.0.3"
}