{"openapi":"3.0.3","info":{"title":"QueRegalar.me Agent API","version":"0.1.0","description":"API para que agentes AI administren una lista personal de regalos usando QREGALARME_TOKEN."},"servers":[{"url":"https://queregalar.me"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"QREGALARME_TOKEN"},"qregalarmeToken":{"type":"apiKey","in":"header","name":"X-QRegalarme-Token"}},"schemas":{"GiftInput":{"type":"object","required":["title"],"properties":{"title":{"type":"string","maxLength":140,"examples":["Cafetera moka"]},"description":{"type":"string","examples":["De acero, tamaño 6 tazas"]},"url":{"type":"string","examples":["https://example.com/producto"]},"image_url":{"type":"string"},"price":{"type":"string","examples":["450"]},"currency":{"type":"string","examples":["MXN"]},"priority":{"type":"string","enum":["alto","normal","bajo"],"default":"normal"},"status":{"type":"string","enum":["available","reserved","received","hidden"],"default":"available"}}},"Gift":{"allOf":[{"$ref":"#/components/schemas/GiftInput"},{"type":"object","properties":{"id":{"type":"integer"},"reserved_by":{"type":"string"},"reserved_note":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}}}]}}},"paths":{"/api/agent/me":{"get":{"operationId":"getCurrentUser","summary":"Ver dueño del token","responses":{"200":{"description":"Usuario autenticado"},"401":{"description":"Token inválido"}}}},"/api/agent/gifts":{"get":{"operationId":"listGifts","summary":"Listar regalos","responses":{"200":{"description":"Lista de regalos"}}},"post":{"operationId":"createGift","summary":"Crear regalo","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftInput"}}}},"responses":{"201":{"description":"Regalo creado"},"400":{"description":"title_required"}}}},"/api/agent/gifts/{id}":{"patch":{"operationId":"updateGift","summary":"Actualizar regalo","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftInput"}}}},"responses":{"200":{"description":"Regalo actualizado"},"404":{"description":"No encontrado"}}},"delete":{"operationId":"deleteGift","summary":"Borrar regalo","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Borrado o no existente"}}}}}}