Memory · GPT アクション

{
  "openapi": "3.1.0",
  "info": {
    "title": "rlab Events Webhook API",
    "description": "API para interactuar con eventos y webhooks de rlab.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://events.rlab.fi",
      "description": "Servidor principal de la API en rlab"
    }
  ],
  "paths": {
    "/webhook/createCode": {
      "get": {
        "operationId": "createCode",
        "summary": "Enviar un código de verificación al email especificado.",
        "parameters": [
          {
            "name": "email",
            "in": "query",
            "required": true,
            "description": "Email al cual enviar el código.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": true,
            "description": "Nombre del usuario para personalizar la interacción.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Código enviado correctamente.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "success"
                    },
                    "message": {
                      "type": "string",
                      "example": "code sent to memory@rlab.fi"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Parámetros inválidos o error en el envío."
          }
        }
      }
    },
    "/webhook/verifyCode": {
      "get": {
        "operationId": "verifyCode",
        "summary": "Valida el código enviado al email.",
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": true,
            "description": "Código de verificación a validar.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "email",
            "in": "query",
            "required": true,
            "description": "Email asociado al código.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Código validado correctamente.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "valid"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Código inválido o error en la validación."
          }
        }
      }
    },
    "/webhook/getMemory": {
      "get": {
        "operationId": "getMemory",
        "summary": "Recupera una memoria guardada usando el código de validación y el email.",
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": true,
            "description": "Código de validación.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "email",
            "in": "query",
            "required": true,
            "description": "Email asociado a la memoria.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Memoria recuperada con éxito.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "success"
                    },
                    "memoria": {
                      "type": "string",
                      "example": "El Oso es blanco y grande."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Solicitud inválida o error al recuperar la memoria."
          }
        }
      }
    },
    "/webhook/saveMemory": {
      "put": {
        "operationId": "saveMemory",
        "summary": "Guarda una nueva memoria.",
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": true,
            "description": "Código de validación.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "email",
            "in": "query",
            "required": true,
            "description": "Codigo asociado a la memoria.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "newMemory": {
                    "type": "string",
                    "description": "La memoria que el usuario desea guardar."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Memoria guardada con éxito.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "string",
                      "example": "true"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Solicitud inválida o error al guardar la memoria."
          }
        }
      }
    },
    "/webhook/removeMemory": {
      "delete": {
        "operationId": "removeMemory",
        "summary": "Remueve el acceso a una memoria específica.",
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": true,
            "description": "Código de validación asociado a la memoria.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "email",
            "in": "query",
            "required": true,
            "description": "Email asociado a la memoria a cerrar o eliminar.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "permanently",
            "in": "query",
            "required": true,
            "description": "Solo si el valor es true entonces eliminara permanentemente la memoria. De otra forma simplemente se enviara false y se cerrara la memoria. Requiriendo validar un nuevo codigo para acceder nuevamente a esta.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Memoria eliminada con éxito.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "true"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Solicitud inválida o error al eliminar la memoria."
          }
        }
      }
    }
  }
}