{"openapi":"3.1.0","paths":{"/v1/settings":{"get":{"operationId":"SettingsController_get","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Configurações"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Ver configurações","description":"Devolve as configurações da loja: nome, moeda, e-mails e regras de checkout."},"patch":{"operationId":"SettingsController_update","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSettingsDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Configurações"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Alterar configurações","description":"Altera só os campos enviados das configurações da loja."}},"/v1/api-keys":{"get":{"operationId":"ApiKeysController_list","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Chaves de API"],"security":[{"bearer":[]}],"x-permission":"apiKeys:read","summary":"Listar chaves de API","description":"Lista as chaves da loja com prefixo, permissões e último uso. O segredo nunca volta."}},"/v1/categories":{"get":{"operationId":"CategoriesController_list","parameters":[{"name":"parentId","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Categorias"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar categorias","description":"Lista as categorias da loja na ordem da vitrine."},"post":{"operationId":"CategoriesController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCategoryDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Categorias"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Criar categoria","description":"Cria uma categoria. Categorias escalonadas viram uma escada de ranks com upgrade pagando a diferença."}},"/v1/categories/order":{"put":{"operationId":"CategoriesController_reorder","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCategoriesDto"}}}},"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Categorias"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Ordenar categorias","description":"Define a ordem das categorias na vitrine pela lista de ids enviada."}},"/v1/categories/{id}":{"get":{"operationId":"CategoriesController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Categorias"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver categoria","description":"Devolve uma categoria."},"patch":{"operationId":"CategoriesController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCategoryDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Categorias"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Alterar categoria","description":"Altera só os campos enviados da categoria."},"delete":{"operationId":"CategoriesController_archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Categorias"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Arquivar categoria","description":"Tira a categoria da vitrine. Pedidos antigos continuam apontando para ela."}},"/v1/products":{"get":{"operationId":"ProductsController_list","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["ACTIVE","ARCHIVED"]}},{"name":"categoryId","required":false,"in":"query","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"maxLength":100,"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar produtos","description":"Lista os produtos da loja, com busca e filtro por categoria."},"post":{"operationId":"ProductsController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Criar produto","description":"Cria um produto com preço em centavos, imagem, descrição e regras de compra."}},"/v1/products/order":{"put":{"operationId":"ProductsController_reorder","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderProductsDto"}}}},"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Ordenar produtos","description":"Define a ordem dos produtos dentro da categoria pela lista de ids enviada."}},"/v1/products/{id}":{"get":{"operationId":"ProductsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver produto","description":"Devolve um produto com preços, regras e ações de entrega."},"patch":{"operationId":"ProductsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Alterar produto","description":"Altera só os campos enviados do produto."},"delete":{"operationId":"ProductsController_archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Arquivar produto","description":"Tira o produto da vitrine. Pedidos e benefícios já entregues não mudam."}},"/v1/products/{id}/requirements":{"get":{"operationId":"ProductsController_requirements","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver requisitos do produto","description":"Pacotes que o comprador precisa ter (ou não ter) para comprar este produto."},"put":{"operationId":"ProductsController_setRequirements","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequirementsDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Definir requisitos do produto","description":"Substitui a lista de pacotes exigidos ou proibidos para comprar este produto."}},"/v1/products/{id}/upsells":{"get":{"operationId":"ProductsController_upsells","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver ofertas do produto","description":"Produtos oferecidos junto no checkout quando este está no carrinho."},"put":{"operationId":"ProductsController_setUpsells","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsellsDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Produtos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Definir ofertas do produto","description":"Substitui os produtos oferecidos junto no checkout."}},"/v1/products/{productId}/prices":{"get":{"operationId":"PricesController_list","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"active","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Preços"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar preços","description":"Preços do produto: avulso e de assinatura (mensal, trimestral…)."},"post":{"operationId":"PricesController_create","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePriceDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Preços"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Criar preço","description":"Adiciona um preço ao produto, em centavos, avulso ou recorrente."}},"/v1/products/{productId}/prices/{priceId}":{"patch":{"operationId":"PricesController_update","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"priceId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePriceDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Preços"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Alterar preço","description":"Altera ou desativa um preço. Assinaturas existentes mantêm o valor contratado."}},"/v1/products/{productId}/license-keys":{"get":{"operationId":"LicenseKeysController_list","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["REVOKED","AVAILABLE","ASSIGNED"]}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Chaves de licença"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar chaves de licença","description":"Estoque de chaves do produto: livres, entregues e revogadas."},"post":{"operationId":"LicenseKeysController_import","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportLicenseKeysDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Chaves de licença"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Importar chaves de licença","description":"Adiciona chaves ao estoque. Cada compra paga recebe uma chave por e-mail."}},"/v1/products/{productId}/license-keys/{keyId}/revoke":{"post":{"operationId":"LicenseKeysController_revoke","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"keyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Chaves de licença"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Revogar chave de licença","description":"Marca a chave como revogada; ela não é entregue de novo."}},"/v1/products/{productId}/files":{"get":{"operationId":"FilesController_list","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Arquivos"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar arquivos","description":"Arquivos que o comprador baixa pelo recibo depois do pagamento."},"post":{"operationId":"FilesController_create","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFileDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Arquivos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Adicionar arquivo","description":"Anexa um arquivo ao produto para download após a compra."}},"/v1/products/{productId}/files/{fileId}":{"delete":{"operationId":"FilesController_remove","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Arquivos"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Remover arquivo","description":"Remove o arquivo do produto. Links já enviados deixam de funcionar."}},"/v1/discounts":{"get":{"operationId":"DiscountsController_list","parameters":[{"name":"method","required":false,"in":"query","schema":{"type":"string","enum":["AUTOMATIC","CODE"]}},{"name":"active","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Cupons e promoções"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar cupons e promoções","description":"Lista cupons (com código) e promoções automáticas da loja."},"post":{"operationId":"DiscountsController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDiscountDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Cupons e promoções"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Criar cupom ou promoção","description":"Cria um desconto em porcentagem ou valor, com prazo, limite de usos, gasto mínimo e produtos."}},"/v1/discounts/{id}":{"get":{"operationId":"DiscountsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Cupons e promoções"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver cupom ou promoção","description":"Devolve um desconto com as regras e o número de usos."},"patch":{"operationId":"DiscountsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDiscountDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Cupons e promoções"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Alterar cupom ou promoção","description":"Altera só os campos enviados do desconto."},"delete":{"operationId":"DiscountsController_archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Cupons e promoções"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Arquivar cupom ou promoção","description":"Encerra o desconto. Pedidos que já usaram continuam com ele."}},"/v1/discounts/{id}/redemptions":{"get":{"operationId":"DiscountsController_redemptions","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Cupons e promoções"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Usos do cupom","description":"Pedidos que usaram o desconto, com o valor descontado em cada um."}},"/v1/customers":{"get":{"operationId":"CustomersController_list","parameters":[{"name":"search","required":false,"in":"query","schema":{"maxLength":100,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"example":{"data":[{"id":"cus_mhexample0000steve00001","email":"steve@exemplo.com","name":"Steve","taxId":null,"phone":null,"identities":[{"id":"cid_mhexample0000steve00001","kind":"MINECRAFT","value":"Steve","displayName":"Steve","createdAt":"2026-10-31T21:04:13.000Z"}],"createdAt":"2026-10-31T21:04:13.000Z","updatedAt":"2026-10-31T21:04:13.000Z"}],"hasMore":false}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:read","summary":"Listar clientes","description":"Lista os clientes da loja, com busca por e-mail ou nick."},"post":{"operationId":"CustomersController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCustomerDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Criar cliente","description":"Cadastra um cliente com e-mail e, se quiser, identidades de jogo."}},"/v1/customers/{id}":{"get":{"operationId":"CustomersController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"example":{"id":"cus_mhexample0000steve00001","email":"steve@exemplo.com","name":"Steve","taxId":null,"phone":null,"identities":[{"id":"cid_mhexample0000steve00001","kind":"MINECRAFT","value":"Steve","displayName":"Steve","createdAt":"2026-10-31T21:04:13.000Z"}],"createdAt":"2026-10-31T21:04:13.000Z","updatedAt":"2026-10-31T21:04:13.000Z"}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:read","summary":"Ver cliente","description":"Devolve um cliente com total gasto e número de pedidos."},"patch":{"operationId":"CustomersController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCustomerDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Alterar cliente","description":"Altera só os campos enviados do cliente."},"delete":{"operationId":"CustomersController_archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Arquivar cliente","description":"Arquiva o cliente. Pedidos e benefícios ficam no histórico."}},"/v1/customers/{id}/identities":{"get":{"operationId":"CustomersController_identities","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:read","summary":"Listar identidades","description":"Contas de jogo do cliente (nick do Minecraft, Steam, Discord…)."},"post":{"operationId":"CustomersController_addIdentity","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddIdentityDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Adicionar identidade","description":"Liga uma conta de jogo ao cliente."}},"/v1/customers/{id}/identities/{identityId}":{"delete":{"operationId":"CustomersController_removeIdentity","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"identityId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Remover identidade","description":"Desliga a conta de jogo do cliente."}},"/v1/customers/{id}/entitlements":{"get":{"operationId":"CustomersController_entitlements","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Clientes"],"security":[{"bearer":[]}],"x-permission":"customers:read","summary":"Benefícios do cliente","description":"Benefícios ativos e encerrados do cliente (ranks, assinaturas, itens)."}},"/v1/bans":{"get":{"operationId":"BansController_list","parameters":[{"name":"kind","required":false,"in":"query","schema":{"type":"string","enum":["DISCORD","EMAIL","PLAYER","IP"]}},{"name":"search","required":false,"in":"query","schema":{"maxLength":100,"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Bloqueios"],"security":[{"bearer":[]}],"x-permission":"customers:read","summary":"Listar bloqueios","description":"Jogadores, e-mails, contas do Discord e IPs impedidos de comprar na loja."},"post":{"operationId":"BansController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBanDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Bloqueios"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Bloquear comprador","description":"Impede um jogador, e-mail, conta do Discord ou IP de comprar na loja."}},"/v1/bans/{id}":{"delete":{"operationId":"BansController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Bloqueios"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Desbloquear comprador","description":"Remove o bloqueio."}},"/v1/storefront":{"get":{"operationId":"StorefrontController_get","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Ver vitrine","description":"Rascunho e versão publicada da vitrine da loja."},"patch":{"operationId":"StorefrontController_save","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveDraftDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Salvar rascunho da vitrine","description":"Salva o rascunho da vitrine sem publicar."}},"/v1/storefront/publish":{"post":{"operationId":"StorefrontController_publish","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Publicar vitrine","description":"Publica o rascunho atual; a loja muda na hora."}},"/v1/storefront/preview-link":{"post":{"operationId":"StorefrontController_previewLink","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Link de prévia","description":"Gera um link temporário para ver o rascunho como o comprador verá."}},"/v1/storefronts":{"get":{"operationId":"StorefrontsController_list","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Listar vitrines","description":"Vitrines da loja (temas salvos), com a que está no ar marcada."},"post":{"operationId":"StorefrontsController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStorefrontDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Criar vitrine","description":"Cria uma vitrine a partir de um template."}},"/v1/storefronts/import":{"post":{"operationId":"StorefrontsController_import","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportStorefrontDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Importar vitrine","description":"Cria uma vitrine a partir de um arquivo exportado."}},"/v1/storefronts/{id}":{"get":{"operationId":"StorefrontsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Ver vitrine salva","description":"Devolve uma vitrine salva."},"patch":{"operationId":"StorefrontsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStorefrontDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Alterar vitrine salva","description":"Altera só os campos enviados da vitrine."},"delete":{"operationId":"StorefrontsController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Apagar vitrine salva","description":"Apaga uma vitrine que não está no ar."}},"/v1/storefronts/{id}/publish":{"post":{"operationId":"StorefrontsController_publish","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Publicar vitrine salva","description":"Coloca esta vitrine no ar no lugar da atual."}},"/v1/storefronts/{id}/duplicate":{"post":{"operationId":"StorefrontsController_duplicate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicateStorefrontDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Duplicar vitrine","description":"Cria uma cópia da vitrine para editar sem mexer na original."}},"/v1/storefronts/{id}/export":{"get":{"operationId":"StorefrontsController_export","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Exportar vitrine","description":"Baixa a vitrine num arquivo para importar em outra loja."}},"/v1/storefronts/{id}/preview-link":{"post":{"operationId":"StorefrontsController_previewLink","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Vitrine"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Link de prévia da vitrine salva","description":"Gera um link temporário para ver esta vitrine antes de publicar."}},"/v1/domain":{"get":{"operationId":"DomainsController_get","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Domínio próprio"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Ver domínio próprio","description":"Domínio ligado à loja e o estado da verificação e do certificado."},"put":{"operationId":"DomainsController_set","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetDomainDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Domínio próprio"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Ligar domínio próprio","description":"Liga um domínio seu à loja. Devolve o registro DNS que você precisa criar."},"delete":{"operationId":"DomainsController_remove","parameters":[],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Domínio próprio"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Desligar domínio próprio","description":"Desliga o domínio; a loja volta a responder só no endereço da Rivoo."}},"/v1/domain/verify":{"post":{"operationId":"DomainsController_verify","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Domínio próprio"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Verificar domínio","description":"Confere o DNS agora e, se estiver certo, emite o certificado."}},"/v1/orders":{"get":{"operationId":"OrdersController_list","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["EXPIRED","CANCELED","OPEN","PAID","PARTIALLY_REFUNDED","REFUNDED"]}},{"name":"paid","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"paidFrom","required":false,"in":"query","schema":{"type":"string"}},{"name":"paidTo","required":false,"in":"query","schema":{"type":"string"}},{"name":"source","required":false,"in":"query","schema":{"type":"string","enum":["STOREFRONT","PLUGIN","API","PAYMENT_LINK","SUBSCRIPTION","DISCORD","MANUAL"]}},{"name":"customerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"state","required":false,"in":"query","schema":{"type":"string","enum":["paid","open","closed"]}},{"name":"q","required":false,"in":"query","schema":{"minLength":1,"maxLength":100,"type":"string"}},{"name":"method","required":false,"in":"query","schema":{"type":"string","enum":["PIX","PIX_AUTOMATIC","CARD","BOLETO"]}},{"name":"paymentLinkId","required":false,"in":"query","schema":{"type":"string"}},{"name":"subscriptionId","required":false,"in":"query","schema":{"type":"string"}},{"name":"delivery","required":false,"in":"query","schema":{"type":"string","enum":["pending","failed"]}},{"name":"dispute","required":false,"in":"query","schema":{"type":"string","enum":["open"]}},{"name":"createdFrom","required":false,"in":"query","schema":{"type":"string"}},{"name":"createdTo","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"example":{"data":[{"id":"ord_mhexample0000vip0000001","source":"API","status":"PAID","customerId":"cus_mhexample0000steve00001","externalId":"pedido_123","recipient":{"kind":"MINECRAFT","ref":"Steve","name":"Steve"},"items":[{"id":"oitem_mhexample0000vip00001","productId":"prod_mhexample0000vip00001","priceId":"price_mhexample0000vip0001","name":"VIP+ 30 dias","quantity":1,"unitAmount":{"amount":2990,"currency":"BRL"},"total":{"amount":2990,"currency":"BRL"},"adjustments":[],"recipient":null,"gift":null}],"totals":{"subtotal":{"amount":2990,"currency":"BRL"},"discount":{"amount":0,"currency":"BRL"},"giftCard":{"amount":0,"currency":"BRL"},"total":{"amount":2990,"currency":"BRL"},"refunded":{"amount":0,"currency":"BRL"}},"allowedMethods":["PIX","CARD","BOLETO"],"paidByPaymentId":"pay_mhexample0000vip0000001","note":null,"metadata":{"pedido":"123"},"customer":{"id":"cus_mhexample0000steve00001","name":"Steve","email":"steve@exemplo.com"},"expiresAt":"2026-11-01T21:04:13.000Z","paidAt":"2026-10-31T21:04:51.000Z","expiredAt":null,"canceledAt":null,"createdAt":"2026-10-31T21:04:13.000Z","method":"PIX","paymentLink":null,"dispute":null,"delivery":"done"}],"hasMore":false,"totalCount":1}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Listar pedidos","description":"Lista os pedidos da loja, do mais novo ao mais antigo, com filtro por status e cliente."},"post":{"operationId":"OrdersController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiOrderDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"example":{"id":"ord_mhexample0000vip0000001","source":"API","status":"OPEN","customerId":"cus_mhexample0000steve00001","externalId":"pedido_123","recipient":{"kind":"MINECRAFT","ref":"Steve","name":"Steve"},"items":[{"id":"oitem_mhexample0000vip00001","productId":"prod_mhexample0000vip00001","priceId":"price_mhexample0000vip0001","name":"VIP+ 30 dias","quantity":1,"unitAmount":{"amount":2990,"currency":"BRL"},"total":{"amount":2990,"currency":"BRL"},"adjustments":[],"recipient":null,"gift":null}],"totals":{"subtotal":{"amount":2990,"currency":"BRL"},"discount":{"amount":0,"currency":"BRL"},"giftCard":{"amount":0,"currency":"BRL"},"total":{"amount":2990,"currency":"BRL"},"refunded":{"amount":0,"currency":"BRL"}},"allowedMethods":["PIX","CARD","BOLETO"],"paidByPaymentId":null,"note":null,"metadata":{"pedido":"123"},"customer":{"id":"cus_mhexample0000steve00001","name":"Steve","email":"steve@exemplo.com"},"expiresAt":"2026-11-01T21:04:13.000Z","paidAt":null,"expiredAt":null,"canceledAt":null,"createdAt":"2026-10-31T21:04:13.000Z","checkoutUrl":"https://rivoo.gg/pay/c/ord_mhexample0000vip0000001?k=exemplo"}}}},"400":{"description":"`idempotency_key_required`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_required":{"summary":"Envie o header Idempotency-Key","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_required","title":"Envie o header Idempotency-Key","status":400,"code":"idempotency_key_required","requestId":"req_mhexample0000request0001"}}}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`, `external_id_taken`, `recipient_not_supported`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}},"external_id_taken":{"summary":"Já existe um pedido com este externalId","value":{"type":"https://docs.rivoo.gg/api/erros#external_id_taken","title":"Já existe um pedido com este externalId","status":409,"code":"external_id_taken","requestId":"req_mhexample0000request0001"}},"recipient_not_supported":{"summary":"Este projeto não entrega para jogadores","value":{"type":"https://docs.rivoo.gg/api/erros#recipient_not_supported","title":"Este projeto não entrega para jogadores","status":409,"code":"recipient_not_supported","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`, `product_unavailable`, `total_below_minimum`, `no_payment_method`, `project_unavailable`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}},"product_unavailable":{"summary":"Produto indisponível","value":{"type":"https://docs.rivoo.gg/api/erros#product_unavailable","title":"Produto indisponível","status":422,"code":"product_unavailable","requestId":"req_mhexample0000request0001"}},"total_below_minimum":{"summary":"O total precisa ser de pelo menos R$ 1,00","value":{"type":"https://docs.rivoo.gg/api/erros#total_below_minimum","title":"O total precisa ser de pelo menos R$ 1,00","status":422,"code":"total_below_minimum","requestId":"req_mhexample0000request0001"}},"no_payment_method":{"summary":"Esta loja não tem um meio de pagamento disponível no momento","value":{"type":"https://docs.rivoo.gg/api/erros#no_payment_method","title":"Esta loja não tem um meio de pagamento disponível no momento","status":422,"code":"no_payment_method","requestId":"req_mhexample0000request0001"}},"project_unavailable":{"summary":"Projeto indisponível para vendas","value":{"type":"https://docs.rivoo.gg/api/erros#project_unavailable","title":"Projeto indisponível para vendas","status":422,"code":"project_unavailable","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Criar pedido","description":"Cria um pedido com produtos do catálogo. Mande o comprador para o `checkoutUrl` da resposta para pagar. Use `Idempotency-Key` para não duplicar."}},"/v1/orders/manual":{"post":{"operationId":"OrdersController_manual","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateManualOrderDto"}}}},"responses":{"201":{"description":""},"400":{"description":"`idempotency_key_required`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_required":{"summary":"Envie o header Idempotency-Key","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_required","title":"Envie o header Idempotency-Key","status":400,"code":"idempotency_key_required","requestId":"req_mhexample0000request0001"}}}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`customer_not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"customer_not_found":{"summary":"Cliente não encontrado","value":{"type":"https://docs.rivoo.gg/api/erros#customer_not_found","title":"Cliente não encontrado","status":404,"code":"customer_not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`, `recipient_not_supported`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}},"recipient_not_supported":{"summary":"Este projeto não entrega para jogadores","value":{"type":"https://docs.rivoo.gg/api/erros#recipient_not_supported","title":"Este projeto não entrega para jogadores","status":409,"code":"recipient_not_supported","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`, `product_unavailable`, `project_unavailable`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}},"product_unavailable":{"summary":"Produto indisponível","value":{"type":"https://docs.rivoo.gg/api/erros#product_unavailable","title":"Produto indisponível","status":422,"code":"product_unavailable","requestId":"req_mhexample0000request0001"}},"project_unavailable":{"summary":"Projeto indisponível para vendas","value":{"type":"https://docs.rivoo.gg/api/erros#project_unavailable","title":"Projeto indisponível para vendas","status":422,"code":"project_unavailable","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Registrar pedido manual","description":"Registra uma venda feita fora da Rivoo e roda as entregas dos produtos, sem cobrar."}},"/v1/orders/{id}":{"get":{"operationId":"OrdersController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"example":{"id":"ord_mhexample0000vip0000001","source":"API","status":"PAID","customerId":"cus_mhexample0000steve00001","externalId":"pedido_123","recipient":{"kind":"MINECRAFT","ref":"Steve","name":"Steve"},"items":[{"id":"oitem_mhexample0000vip00001","productId":"prod_mhexample0000vip00001","priceId":"price_mhexample0000vip0001","name":"VIP+ 30 dias","quantity":1,"unitAmount":{"amount":2990,"currency":"BRL"},"total":{"amount":2990,"currency":"BRL"},"adjustments":[],"recipient":null,"gift":null}],"totals":{"subtotal":{"amount":2990,"currency":"BRL"},"discount":{"amount":0,"currency":"BRL"},"giftCard":{"amount":0,"currency":"BRL"},"total":{"amount":2990,"currency":"BRL"},"refunded":{"amount":0,"currency":"BRL"}},"allowedMethods":["PIX","CARD","BOLETO"],"paidByPaymentId":"pay_mhexample0000vip0000001","note":null,"metadata":{"pedido":"123"},"customer":{"id":"cus_mhexample0000steve00001","name":"Steve","email":"steve@exemplo.com"},"expiresAt":"2026-11-01T21:04:13.000Z","paidAt":"2026-10-31T21:04:51.000Z","expiredAt":null,"canceledAt":null,"createdAt":"2026-10-31T21:04:13.000Z"}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Ver pedido","description":"Devolve o pedido com itens, pagamentos, reembolsos e entregas."}},"/v1/orders/{id}/cancel":{"post":{"operationId":"OrdersController_cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`, `order_not_cancelable`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}},"order_not_cancelable":{"summary":"Só pedidos em aberto podem ser cancelados","value":{"type":"https://docs.rivoo.gg/api/erros#order_not_cancelable","title":"Só pedidos em aberto podem ser cancelados","status":409,"code":"order_not_cancelable","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Cancelar pedido","description":"Cancela um pedido ainda não pago; o link de pagamento deixa de funcionar."}},"/v1/orders/{id}/resend-email":{"post":{"operationId":"OrdersController_resendEmail","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"202":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`, `order_not_paid`, `no_buyer_email`, `email_resent_recently`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}},"order_not_paid":{"summary":"Só pedidos pagos têm e-mail de confirmação","value":{"type":"https://docs.rivoo.gg/api/erros#order_not_paid","title":"Só pedidos pagos têm e-mail de confirmação","status":409,"code":"order_not_paid","requestId":"req_mhexample0000request0001"}},"no_buyer_email":{"summary":"O comprador não informou e-mail","value":{"type":"https://docs.rivoo.gg/api/erros#no_buyer_email","title":"O comprador não informou e-mail","status":409,"code":"no_buyer_email","requestId":"req_mhexample0000request0001"}},"email_resent_recently":{"summary":"O e-mail acabou de ser reenviado. Tente de novo em um minuto.","value":{"type":"https://docs.rivoo.gg/api/erros#email_resent_recently","title":"O e-mail acabou de ser reenviado. Tente de novo em um minuto.","status":409,"code":"email_resent_recently","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Reenviar e-mail do pedido","description":"Manda de novo o recibo ao comprador, com chaves e links de download."}},"/v1/payments":{"get":{"operationId":"PaymentsController_list","parameters":[{"name":"orderId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["PENDING","EXPIRED","CANCELED","FAILED","REQUIRES_ACTION","PROCESSING","SUCCEEDED"]}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pagamentos"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Listar pagamentos","description":"Pagamentos recebidos, com meio (Pix, cartão, boleto), taxa e valor líquido."}},"/v1/payments/{id}":{"get":{"operationId":"PaymentsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pagamentos"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Ver pagamento","description":"Devolve um pagamento."}},"/v1/payment-methods":{"get":{"operationId":"PaymentMethodsController_list","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pagamentos"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Listar meios de pagamento","description":"Meios de pagamento da loja e se cada um está ativo."}},"/v1/payment-methods/CARD":{"patch":{"operationId":"PaymentMethodsController_setEnabled","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnabledDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pagamentos"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Ligar ou desligar cartão","description":"Liga ou desliga o pagamento com cartão no checkout."}},"/v1/orders/{id}/refunds":{"get":{"operationId":"RefundsController_listForOrder","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Reembolsos"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Reembolsos do pedido","description":"Reembolsos feitos no pedido."},"post":{"operationId":"RefundsController_create","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRefundDto"}}}},"responses":{"201":{"description":""},"400":{"description":"`idempotency_key_required`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_required":{"summary":"Envie o header Idempotency-Key","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_required","title":"Envie o header Idempotency-Key","status":400,"code":"idempotency_key_required","requestId":"req_mhexample0000request0001"}}}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`, `manual_refund`, `order_not_paid`, `payment_not_refundable`, `payment_disputed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}},"manual_refund":{"summary":"Pedido manual não tem pagamento para reembolsar","value":{"type":"https://docs.rivoo.gg/api/erros#manual_refund","title":"Pedido manual não tem pagamento para reembolsar","status":409,"code":"manual_refund","requestId":"req_mhexample0000request0001"}},"order_not_paid":{"summary":"O pedido não foi pago","value":{"type":"https://docs.rivoo.gg/api/erros#order_not_paid","title":"O pedido não foi pago","status":409,"code":"order_not_paid","requestId":"req_mhexample0000request0001"}},"payment_not_refundable":{"summary":"Só pagamentos confirmados podem ser reembolsados","value":{"type":"https://docs.rivoo.gg/api/erros#payment_not_refundable","title":"Só pagamentos confirmados podem ser reembolsados","status":409,"code":"payment_not_refundable","requestId":"req_mhexample0000request0001"}},"payment_disputed":{"summary":"Pagamento em disputa (ou disputa perdida): o valor sai pela disputa","value":{"type":"https://docs.rivoo.gg/api/erros#payment_disputed","title":"Pagamento em disputa (ou disputa perdida): o valor sai pela disputa","status":409,"code":"payment_disputed","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`, `amount_exceeds_refundable`, `pix_key_required`, `pix_key_not_payer`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}},"amount_exceeds_refundable":{"summary":"Valor acima do reembolsável","value":{"type":"https://docs.rivoo.gg/api/erros#amount_exceeds_refundable","title":"Valor acima do reembolsável","status":422,"code":"amount_exceeds_refundable","requestId":"req_mhexample0000request0001"}},"pix_key_required":{"summary":"Pagamento feito no banco: informe a chave Pix do comprador para devolver","value":{"type":"https://docs.rivoo.gg/api/erros#pix_key_required","title":"Pagamento feito no banco: informe a chave Pix do comprador para devolver","status":422,"code":"pix_key_required","requestId":"req_mhexample0000request0001"}},"pix_key_not_payer":{"summary":"A devolução vai para a chave Pix CPF/CNPJ de quem pagou o boleto","value":{"type":"https://docs.rivoo.gg/api/erros#pix_key_not_payer","title":"A devolução vai para a chave Pix CPF/CNPJ de quem pagou o boleto","status":422,"code":"pix_key_not_payer","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Reembolsos"],"security":[{"bearer":[]}],"x-permission":"refunds:write","summary":"Reembolsar pedido","description":"Reembolsa todo ou parte do pedido. O benefício entregue é retirado quando o produto tem ação de reembolso."}},"/v1/refunds/{id}/destination":{"post":{"operationId":"RefundsController_destination","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundPixKeyDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Reembolsos"],"security":[{"bearer":[]}],"x-permission":"refunds:write","summary":"Informar destino do reembolso","description":"Informa a chave Pix para onde devolver quando o pagamento original não permite devolução automática."}},"/v1/refunds":{"get":{"operationId":"RefundsController_list","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Reembolsos"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Listar reembolsos","description":"Todos os reembolsos da loja."}},"/v1/disputes":{"get":{"operationId":"DisputesController_list","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Disputas"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Listar disputas","description":"Contestações abertas pelos compradores (chargeback e MED do Pix)."}},"/v1/disputes/{id}":{"get":{"operationId":"DisputesController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Disputas"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Ver disputa","description":"Devolve a disputa com prazo e provas enviadas."}},"/v1/disputes/{id}/evidence":{"post":{"operationId":"DisputesController_evidence","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Disputas"],"security":[{"bearer":[]}],"x-permission":"refunds:write","summary":"Enviar prova","description":"Anexa uma prova à disputa (comprovante de entrega, conversa, log do servidor)."}},"/v1/disputes/{id}/submit":{"post":{"operationId":"DisputesController_submit","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Disputas"],"security":[{"bearer":[]}],"x-permission":"refunds:write","summary":"Enviar defesa","description":"Envia as provas para análise. Depois disso não dá para anexar mais."}},"/v1/disputes/{id}/accept":{"post":{"operationId":"DisputesController_accept","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Disputas"],"security":[{"bearer":[]}],"x-permission":"refunds:write","summary":"Aceitar disputa","description":"Aceita a contestação sem defesa; o valor volta ao comprador."}},"/v1/payment-links":{"get":{"operationId":"PaymentLinksController_list","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Links de pagamento"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Listar links de pagamento","description":"Links de pagamento da loja."},"post":{"operationId":"PaymentLinksController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLinkDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Links de pagamento"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Criar link de pagamento","description":"Cria um link com produtos e quantidades. Único (paga uma vez) ou fixo (paga várias vezes)."}},"/v1/payment-links/{id}":{"get":{"operationId":"PaymentLinksController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Links de pagamento"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Ver link de pagamento","description":"Devolve o link com os pedidos que ele gerou."},"patch":{"operationId":"PaymentLinksController_patch","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchLinkDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Links de pagamento"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Alterar link de pagamento","description":"Altera só os campos enviados do link."},"delete":{"operationId":"PaymentLinksController_archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Links de pagamento"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Arquivar link de pagamento","description":"Desativa o link; quem abrir vê que ele não está mais disponível."}},"/v1/subscriptions":{"get":{"operationId":"SubscriptionsController_list","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["ACTIVE","CANCELED","ENDED","INCOMPLETE","PAST_DUE"]}},{"name":"customerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"state","required":false,"in":"query","schema":{"type":"string","enum":["active","past_due","ending","incomplete","ended"]}},{"name":"productId","required":false,"in":"query","schema":{"type":"string"}},{"name":"method","required":false,"in":"query","schema":{"type":"string","enum":["PIX","PIX_AUTOMATIC","CARD","BOLETO"]}},{"name":"q","required":false,"in":"query","schema":{"minLength":1,"maxLength":100,"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Assinaturas"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Listar assinaturas","description":"Assinaturas da loja, com status e próxima cobrança."},"post":{"operationId":"SubscriptionsController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDto"}}}},"responses":{"201":{"description":""},"400":{"description":"`idempotency_key_required`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_required":{"summary":"Envie o header Idempotency-Key","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_required","title":"Envie o header Idempotency-Key","status":400,"code":"idempotency_key_required","requestId":"req_mhexample0000request0001"}}}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Assinaturas"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Criar assinatura","description":"Cria uma assinatura e devolve o link para o comprador autorizar o Pix Automático ou o cartão."}},"/v1/subscriptions/summary":{"get":{"operationId":"SubscriptionsController_summary","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Assinaturas"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Resumo das assinaturas","description":"Ativas, receita recorrente do mês e cancelamentos."}},"/v1/subscriptions/{id}":{"get":{"operationId":"SubscriptionsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Assinaturas"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Ver assinatura","description":"Devolve a assinatura com as cobranças."}},"/v1/subscriptions/{id}/cancel":{"post":{"operationId":"SubscriptionsController_cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Assinaturas"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Cancelar assinatura","description":"Cancela a renovação. O benefício vale até o fim do período pago."}},"/v1/subscriptions/{id}/resume":{"post":{"operationId":"SubscriptionsController_resume","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Assinaturas"],"security":[{"bearer":[]}],"x-permission":"orders:write","summary":"Retomar assinatura","description":"Desfaz o cancelamento antes do fim do período."}},"/v1/media":{"post":{"operationId":"MediaController_upload","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Imagens"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Enviar imagem","description":"Envia uma imagem (até 2 MB, em base64) para usar em produtos e na vitrine."},"get":{"operationId":"MediaController_list","parameters":[{"name":"search","required":false,"in":"query","schema":{"maxLength":100,"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Imagens"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar imagens","description":"Imagens enviadas pela loja."}},"/v1/media/{id}":{"delete":{"operationId":"MediaController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Imagens"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Apagar imagem","description":"Apaga a imagem. Produtos que usavam ficam sem ela."}},"/v1/connections/{id}/discord/roles":{"get":{"operationId":"DiscordInstallController_roles","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Discord"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Cargos do Discord","description":"Cargos do servidor do Discord, para usar nas ações de entrega."}},"/v1/connections/{id}/discord/channels":{"get":{"operationId":"DiscordInstallController_channels","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Discord"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Canais do Discord","description":"Canais de texto do servidor do Discord, para os avisos de venda."}},"/v1/connections/{id}/discord":{"get":{"operationId":"DiscordInstallController_settings","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Discord"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Ver avisos do Discord","description":"Canal e modelo do anúncio público de venda e do canal da equipe."},"patch":{"operationId":"DiscordInstallController_patch","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuildPatchDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Discord"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Configurar avisos do Discord","description":"Define os canais e o modelo da mensagem de venda."}},"/v1/connections/{id}/discord/test":{"post":{"operationId":"DiscordInstallController_test","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuildTestDto"}}}},"responses":{"202":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Discord"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Testar avisos do Discord","description":"Manda uma mensagem de teste nos canais configurados."}},"/v1/connections":{"get":{"operationId":"ConnectionsController_list","parameters":[{"name":"type","required":false,"in":"query","schema":{"type":"string","enum":["MINECRAFT","FIVEM","REDM","RUST","HYTALE","DISCORD","GAME_AGENT"]}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["ACTIVE","REMOVED","DISCONNECTED"]}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Listar servidores","description":"Servidores de jogo ligados à loja (plugin ou agente) e se estão online."},"post":{"operationId":"ConnectionsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectionDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Adicionar servidor","description":"Cria a conexão de um servidor e devolve a chave que vai no plugin."}},"/v1/connections/{id}":{"get":{"operationId":"ConnectionsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Ver servidor","description":"Devolve o servidor com o último contato."},"patch":{"operationId":"ConnectionsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateConnectionDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Alterar servidor","description":"Altera só os campos enviados do servidor."},"delete":{"operationId":"ConnectionsController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Remover servidor","description":"Desliga o servidor da loja; a chave para de funcionar."}},"/v1/connections/{id}/rotate-key":{"post":{"operationId":"ConnectionsController_rotate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Trocar chave do servidor","description":"Gera uma chave nova e invalida a antiga."}},"/v1/connection-pairings/{code}":{"get":{"operationId":"ConnectionsController_preview","parameters":[{"name":"code","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Ver pareamento","description":"Mostra o servidor que pediu pareamento com o código exibido no console."}},"/v1/connection-pairings/{code}/claim":{"post":{"operationId":"ConnectionsController_claim","parameters":[{"name":"code","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimPairingDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Confirmar pareamento","description":"Liga à loja o servidor que mostrou o código no console."}},"/v1/connections/cloud-agents":{"post":{"operationId":"CloudAgentsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCloudAgentDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Adicionar servidor por RCON","description":"Liga um servidor pelo RCON, sem instalar nada nele (beta)."}},"/v1/connections/{id}/cloud-agent":{"patch":{"operationId":"CloudAgentsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCloudAgentDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Servidores"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Alterar servidor por RCON","description":"Altera endereço, porta ou senha do RCON."}},"/v1/reports/summary":{"get":{"operationId":"ReportsController_summary","parameters":[{"name":"from","required":false,"in":"query","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Relatórios"],"security":[{"bearer":[]}],"x-permission":"reports:read","summary":"Resumo de vendas","description":"Vendas, receita, ticket médio e reembolsos no período."}},"/v1/reports/timeseries":{"get":{"operationId":"ReportsController_timeseries","parameters":[{"name":"from","required":false,"in":"query","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","schema":{"type":"string"}},{"name":"metric","required":false,"in":"query","schema":{"type":"string","enum":["revenue","orders","refunds"]}},{"name":"interval","required":false,"in":"query","schema":{"type":"string","enum":["day","week","month"]}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Relatórios"],"security":[{"bearer":[]}],"x-permission":"reports:read","summary":"Vendas por dia","description":"Série de vendas e receita por dia no período."}},"/v1/reports/top-products":{"get":{"operationId":"ReportsController_topProducts","parameters":[{"name":"from","required":false,"in":"query","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Relatórios"],"security":[{"bearer":[]}],"x-permission":"reports:read","summary":"Produtos mais vendidos","description":"Produtos com mais receita no período."}},"/v1/reports/top-customers":{"get":{"operationId":"ReportsController_topCustomers","parameters":[{"name":"from","required":false,"in":"query","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Relatórios"],"security":[{"bearer":[]}],"x-permission":"reports:read","summary":"Melhores clientes","description":"Clientes que mais gastaram no período."}},"/v1/reports/conversion":{"get":{"operationId":"ReportsController_conversion","parameters":[{"name":"from","required":false,"in":"query","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Relatórios"],"security":[{"bearer":[]}],"x-permission":"reports:read","summary":"Conversão","description":"Pedidos criados, pagos e a taxa de conversão no período."}},"/v1/products/{productId}/actions":{"get":{"operationId":"ActionsController_listProduct","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Listar ações do produto","description":"Comandos e cargos que o produto entrega quando o pedido é pago, expira ou é reembolsado."},"post":{"operationId":"ActionsController_createProduct","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateActionDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Criar ação do produto","description":"Adiciona um comando no servidor ou cargo no Discord ao produto, com o momento em que roda."}},"/v1/products/{productId}/actions/{actionId}":{"patch":{"operationId":"ActionsController_updateProduct","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"actionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateActionDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Alterar ação do produto","description":"Altera só os campos enviados da ação."},"delete":{"operationId":"ActionsController_removeProduct","parameters":[{"name":"productId","required":true,"in":"path","schema":{"type":"string"}},{"name":"actionId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Remover ação do produto","description":"Remove a ação. Entregas já feitas não são desfeitas."}},"/v1/actions":{"get":{"operationId":"ActionsController_listProject","parameters":[{"name":"scope","required":false,"in":"query","schema":{"type":"string","enum":["project","all"]}},{"name":"type","required":false,"in":"query","schema":{"type":"string","enum":["MANUAL","COMMAND","DISCORD_ROLE","FILE","LICENSE_KEY"]}},{"name":"limit","required":false,"in":"query","schema":{"type":"string"}},{"name":"after","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Listar ações da loja","description":"Ações que rodam em toda compra, de qualquer produto."},"post":{"operationId":"ActionsController_createProject","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateActionDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Criar ação da loja","description":"Adiciona um comando ou cargo que roda em toda compra."}},"/v1/actions/{actionId}":{"patch":{"operationId":"ActionsController_updateProject","parameters":[{"name":"actionId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateActionDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Alterar ação da loja","description":"Altera só os campos enviados da ação."},"delete":{"operationId":"ActionsController_removeProject","parameters":[{"name":"actionId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Ações de entrega"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Remover ação da loja","description":"Remove a ação da loja."}},"/v1/entitlements":{"get":{"operationId":"EntitlementsController_list","parameters":[{"name":"customerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"productId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["ACTIVE","EXPIRED","REVOKED","REPLACED"]}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Benefícios"],"security":[{"bearer":[]}],"x-permission":"customers:read","summary":"Listar benefícios","description":"Benefícios entregues (ranks, assinaturas, itens), com início e fim."}},"/v1/entitlements/{id}/revoke":{"post":{"operationId":"EntitlementsController_revoke","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Benefícios"],"security":[{"bearer":[]}],"x-permission":"customers:write","summary":"Revogar benefício","description":"Encerra o benefício agora e roda as ações de fim do produto."}},"/v1/command-runs":{"get":{"operationId":"CommandRunsController_list","parameters":[{"name":"connectionId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["DONE","PENDING","EXPIRED","CANCELED","FAILED"]}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Comandos"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Listar comandos","description":"Comandos enviados aos servidores, com status (na fila, entregue, falhou)."},"post":{"operationId":"CommandRunsController_test","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestCommandDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Comandos"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Enviar comando de teste","description":"Envia um comando a um servidor, sem pedido, para testar a entrega."}},"/v1/command-runs/{id}":{"get":{"operationId":"CommandRunsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Comandos"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Ver comando","description":"Devolve o comando com as tentativas e a resposta do servidor."}},"/v1/command-runs/resend":{"post":{"operationId":"CommandRunsController_resend","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendDto"}}}},"responses":{"200":{"description":""},"400":{"description":"`idempotency_key_required`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_required":{"summary":"Envie o header Idempotency-Key","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_required","title":"Envie o header Idempotency-Key","status":400,"code":"idempotency_key_required","requestId":"req_mhexample0000request0001"}}}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Comandos"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Reenviar comandos","description":"Reenvia ao servidor os comandos de um pedido."}},"/v1/command-runs/{id}/cancel":{"post":{"operationId":"CommandRunsController_cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Comandos"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Cancelar comando","description":"Cancela um comando que ainda está na fila."}},"/v1/deliveries/manual":{"get":{"operationId":"ManualDeliveriesController_list","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["PENDING","CANCELED","FAILED","SUCCEEDED"]}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Entregas"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Entregas manuais pendentes","description":"Itens que a equipe entrega à mão."}},"/v1/deliveries/manual/count":{"get":{"operationId":"ManualDeliveriesController_count","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Entregas"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Contar entregas manuais","description":"Quantas entregas manuais estão pendentes."}},"/v1/deliveries/manual/{id}/delivered":{"post":{"operationId":"ManualDeliveriesController_delivered","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Entregas"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Marcar como entregue","description":"Marca a entrega manual como feita."}},"/v1/deliveries":{"get":{"operationId":"DeliveriesController_list","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["PENDING","CANCELED","FAILED","SUCCEEDED"]}},{"name":"orderId","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Entregas"],"security":[{"bearer":[]}],"x-permission":"delivery:read","summary":"Listar entregas","description":"Entregas dos pedidos (comandos, cargos, chaves, arquivos) e o status de cada uma."}},"/v1/deliveries/{id}/retry":{"post":{"operationId":"DeliveriesController_retry","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Entregas"],"security":[{"bearer":[]}],"x-permission":"delivery:write","summary":"Tentar entrega de novo","description":"Roda de novo uma entrega que falhou."}},"/v1/webhook-endpoints":{"get":{"operationId":"EndpointsController_list","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:read","summary":"Listar webhooks","description":"Endereços que recebem os eventos da loja."},"post":{"operationId":"EndpointsController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEndpointDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"example":{"id":"whe_mhexample0000hook000001","name":"Meu servidor","url":"https://exemplo.com/webhooks/rivoo","events":["order.paid","order.refunded"],"status":"ENABLED","disabledReason":null,"rotation":null,"createdAt":"2026-10-31T21:04:13.000Z","updatedAt":"2026-10-31T21:04:13.000Z","secret":"whsec_exemplo_nao_use"}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:write","summary":"Criar webhook","description":"Cadastra uma URL e os eventos que ela recebe. O segredo de assinatura aparece só nesta resposta."}},"/v1/webhook-endpoints/{id}":{"get":{"operationId":"EndpointsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"example":{"id":"whe_mhexample0000hook000001","name":"Meu servidor","url":"https://exemplo.com/webhooks/rivoo","events":["order.paid","order.refunded"],"status":"ENABLED","disabledReason":null,"rotation":null,"createdAt":"2026-10-31T21:04:13.000Z","updatedAt":"2026-10-31T21:04:13.000Z"}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:read","summary":"Ver webhook","description":"Devolve o webhook com os eventos assinados."},"patch":{"operationId":"EndpointsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEndpointDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:write","summary":"Alterar webhook","description":"Altera URL, eventos ou pausa o envio."},"delete":{"operationId":"EndpointsController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:write","summary":"Apagar webhook","description":"Para de enviar eventos para a URL."}},"/v1/webhook-endpoints/{id}/rotate-secret":{"post":{"operationId":"EndpointsController_rotate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:write","summary":"Trocar segredo do webhook","description":"Gera um segredo de assinatura novo. O antigo continua valendo por 24 horas, para você trocar sem perder eventos."}},"/v1/webhook-endpoints/{id}/test":{"post":{"operationId":"EndpointsController_test","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:write","summary":"Testar webhook","description":"Envia um evento de teste para a URL."}},"/v1/webhook-endpoints/{id}/deliveries":{"get":{"operationId":"EndpointsController_deliveries","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Webhooks"],"security":[{"bearer":[]}],"x-permission":"webhooks:read","summary":"Envios do webhook","description":"Tentativas de envio para a URL, com o código de resposta de cada uma."}},"/v1/events":{"get":{"operationId":"EventsController_list","parameters":[{"name":"type","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Eventos"],"security":[{"bearer":[]}],"x-permission":"webhooks:read","summary":"Listar eventos","description":"Eventos da loja (pedido pago, reembolso, assinatura…), do mais novo ao mais antigo."}},"/v1/events/{id}":{"get":{"operationId":"EventsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Eventos"],"security":[{"bearer":[]}],"x-permission":"webhooks:read","summary":"Ver evento","description":"Devolve o evento com o mesmo corpo enviado aos webhooks."}},"/v1/creators":{"get":{"operationId":"CreatorsController_list","parameters":[{"name":"archived","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar criadores","description":"Criadores de conteúdo com código de desconto e comissão."},"post":{"operationId":"CreatorsController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCreatorDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Criar criador","description":"Cadastra um criador com código, desconto para o comprador e comissão."}},"/v1/creators/{id}":{"get":{"operationId":"CreatorsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver criador","description":"Devolve o criador."},"patch":{"operationId":"CreatorsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCreatorDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Alterar criador","description":"Altera só os campos enviados do criador."},"delete":{"operationId":"CreatorsController_archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Arquivar criador","description":"Desativa o código do criador."}},"/v1/creators/{id}/report":{"get":{"operationId":"CreatorsController_report","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Relatório do criador","description":"Vendas e comissão do criador por mês, descontados reembolsos e disputas perdidas."}},"/v1/creators/{id}/payouts":{"get":{"operationId":"CreatorsController_payouts","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Pagamentos ao criador","description":"Pagamentos de comissão registrados pela loja."},"post":{"operationId":"CreatorsController_addPayout","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePayoutDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Registrar pagamento ao criador","description":"Registra que a loja pagou a comissão do criador."}},"/v1/creators/{id}/payouts/{payoutId}":{"delete":{"operationId":"CreatorsController_removePayout","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"payoutId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Criadores"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Apagar pagamento ao criador","description":"Remove um registro de pagamento de comissão."}},"/v1/settings/recovery":{"get":{"operationId":"EngagementSettingsController_get","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Recuperação de carrinho"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Ver recuperação de carrinho","description":"Devolve o lembrete de carrinho abandonado e o agradecimento pós-compra, com os cupons de cada um."},"put":{"operationId":"EngagementSettingsController_set","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverySettingsDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Recuperação de carrinho"],"security":[{"bearer":[]}],"x-permission":"settings:write","summary":"Configurar recuperação de carrinho","description":"Liga, desliga e ajusta o lembrete de carrinho abandonado e o agradecimento pós-compra."}},"/v1/settings/recovery/stats":{"get":{"operationId":"EngagementSettingsController_stats","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Recuperação de carrinho"],"security":[{"bearer":[]}],"x-permission":"settings:read","summary":"Números da recuperação","description":"Lembretes enviados, pedidos recuperados e valor recuperado no mês."}},"/v1/community-goal":{"get":{"operationId":"CommunityGoalController_get","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Meta da comunidade"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver meta da comunidade","description":"Meta de vendas do mês, progresso e ações ao bater."},"put":{"operationId":"CommunityGoalController_set","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoalDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Meta da comunidade"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Configurar meta da comunidade","description":"Define o valor, o ciclo e o que acontece quando a meta é batida."}},"/v1/community-goal/reaches":{"get":{"operationId":"CommunityGoalController_reaches","parameters":[],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Meta da comunidade"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Metas batidas","description":"Histórico das vezes em que a meta foi batida."}},"/v1/gift-cards":{"get":{"operationId":"GiftCardsController_list","parameters":[{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["ACTIVE","DISABLED","VOIDED"]}},{"name":"q","required":false,"in":"query","schema":{"minLength":1,"maxLength":4,"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Gift cards"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Listar gift cards","description":"Gift cards da loja com saldo."},"post":{"operationId":"GiftCardsController_create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGiftCardDto"}}}},"responses":{"201":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Gift cards"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Criar gift card","description":"Cria um gift card com saldo e, se quiser, manda por e-mail."}},"/v1/gift-cards/batch":{"post":{"operationId":"GiftCardsController_batch","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDto"}}}},"responses":{"201":{"description":""},"400":{"description":"`idempotency_key_required`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_required":{"summary":"Envie o header Idempotency-Key","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_required","title":"Envie o header Idempotency-Key","status":400,"code":"idempotency_key_required","requestId":"req_mhexample0000request0001"}}}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Gift cards"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Criar gift cards em lote","description":"Cria vários gift cards de uma vez."}},"/v1/gift-cards/{id}/top-up":{"post":{"operationId":"GiftCardsController_topUp","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopUpDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Gift cards"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Recarregar gift card","description":"Adiciona saldo a um gift card."}},"/v1/gift-cards/{id}":{"get":{"operationId":"GiftCardsController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Gift cards"],"security":[{"bearer":[]}],"x-permission":"catalog:read","summary":"Ver gift card","description":"Devolve o gift card com saldo e usos."},"patch":{"operationId":"GiftCardsController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateGiftCardDto"}}}},"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Gift cards"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Alterar gift card","description":"Altera validade ou desativa o gift card."}},"/v1/gift-cards/{id}/resend":{"post":{"operationId":"GiftCardsController_resend","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"responses":{"202":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Gift cards"],"security":[{"bearer":[]}],"x-permission":"catalog:write","summary":"Reenviar gift card","description":"Manda de novo o e-mail com o código do gift card."}},"/v1/orders/{id}/gift-card-credits":{"get":{"operationId":"OrderGiftCardsController_list","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"orders:read","summary":"Gift cards usados no pedido","description":"Gift cards que pagaram parte ou todo o pedido."}},"/v1/orders/{id}/gift-card-credit":{"post":{"operationId":"OrderGiftCardsController_credit","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditDto"}}}},"responses":{"201":{"description":""},"400":{"description":"`idempotency_key_required`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_key_required":{"summary":"Envie o header Idempotency-Key","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_required","title":"Envie o header Idempotency-Key","status":400,"code":"idempotency_key_required","requestId":"req_mhexample0000request0001"}}}}}},"401":{"description":"`unauthenticated`, `invalid_api_key`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthenticated":{"summary":"Credencial ausente ou inválida","value":{"type":"https://docs.rivoo.gg/api/erros#unauthenticated","title":"Credencial ausente ou inválida","status":401,"code":"unauthenticated","requestId":"req_mhexample0000request0001"}},"invalid_api_key":{"summary":"Chave inválida, revogada ou vencida","value":{"type":"https://docs.rivoo.gg/api/erros#invalid_api_key","title":"Chave inválida, revogada ou vencida","status":401,"code":"invalid_api_key","requestId":"req_mhexample0000request0001"}}}}}},"403":{"description":"`permission_denied`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"permission_denied":{"summary":"Sem permissão para esta ação","value":{"type":"https://docs.rivoo.gg/api/erros#permission_denied","title":"Sem permissão para esta ação","status":403,"code":"permission_denied","requestId":"req_mhexample0000request0001"}}}}}},"404":{"description":"`not_found`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"not_found":{"summary":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","value":{"type":"https://docs.rivoo.gg/api/erros#not_found","title":"O recurso não existe nesta loja (o `code` diz qual, ex.: `order_not_found`)","status":404,"code":"not_found","requestId":"req_mhexample0000request0001"}}}}}},"409":{"description":"`idempotency_in_progress`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"idempotency_in_progress":{"summary":"A mesma Idempotency-Key ainda está sendo processada","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_in_progress","title":"A mesma Idempotency-Key ainda está sendo processada","status":409,"code":"idempotency_in_progress","requestId":"req_mhexample0000request0001"}}}}}},"422":{"description":"`validation_failed`, `idempotency_key_reused`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"validation_failed":{"summary":"Dados inválidos","value":{"type":"https://docs.rivoo.gg/api/erros#validation_failed","title":"Dados inválidos","status":422,"code":"validation_failed","requestId":"req_mhexample0000request0001"}},"idempotency_key_reused":{"summary":"Idempotency-Key já usada com outro corpo","value":{"type":"https://docs.rivoo.gg/api/erros#idempotency_key_reused","title":"Idempotency-Key já usada com outro corpo","status":422,"code":"idempotency_key_reused","requestId":"req_mhexample0000request0001"}}}}}},"429":{"description":"`rate_limited`","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"rate_limited":{"summary":"Muitas requisições; tente de novo em instantes","value":{"type":"https://docs.rivoo.gg/api/erros#rate_limited","title":"Muitas requisições; tente de novo em instantes","status":429,"code":"rate_limited","requestId":"req_mhexample0000request0001"}}}}}}},"tags":["Pedidos"],"security":[{"bearer":[]}],"x-permission":"refunds:write","summary":"Devolver em gift card","description":"Devolve o valor do pedido como saldo num gift card, em vez de reembolsar."}}},"info":{"title":"Rivoo API","description":"API da Rivoo: pedidos, catálogo, clientes, entregas e webhooks da sua loja. Autentique com a chave de API no header `Authorization: Bearer`.","version":"1","contact":{}},"tags":[],"servers":[{"url":"https://api.rivoo.gg"}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"chave de API","type":"http","description":"Chave de API da loja (Painel › Integrações › Chaves de API)"}},"schemas":{"GoogleLoginDto":{"type":"object","properties":{"idToken":{"type":"string","minLength":20,"maxLength":4096}},"required":["idToken"]},"EmailLinkDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"turnstileToken":{"type":"string","maxLength":2048},"surface":{"type":"string","enum":["panel","console"]}},"required":["email"]},"EmailLinkVerifyDto":{"type":"object","properties":{"token":{"type":"string","minLength":20,"maxLength":200}},"required":["token"]},"RefreshDto":{"type":"object","properties":{"refreshToken":{"type":"string","minLength":20,"maxLength":200}},"required":["refreshToken"]},"UpdateMeDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120}},"required":["name"]},"CreateAccountDto":{"type":"object","properties":{"tradeName":{"type":"string","minLength":2,"maxLength":120},"referral":{"type":"string","maxLength":60},"userName":{"type":"string","minLength":2,"maxLength":80}}},"UpdateAccountDto":{"type":"object","properties":{"tradeName":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email"}}},"UpdateMemberDto":{"type":"object","properties":{"role":{"type":"string","enum":["ADMIN","MEMBER"]}},"required":["role"]},"ProjectGrantDto":{"type":"object","properties":{"projectId":{"type":"string"},"role":{"type":"string","enum":["ADMIN","FINANCE","DEVELOPER","SUPPORT"]}},"required":["projectId","role"]},"MemberAccessDto":{"type":"object","properties":{"role":{"type":"string","enum":["ADMIN","MEMBER"]},"projects":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ProjectGrantDto"}}},"required":["role"]},"InviteDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["ADMIN","MEMBER"]},"projects":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ProjectGrantDto"}}},"required":["email","role"]},"AcceptInvitationDto":{"type":"object","properties":{"token":{"type":"string","minLength":20,"maxLength":200}},"required":["token"]},"UpdateOwnerDto":{"type":"object","properties":{"type":{"type":"string","enum":["INDIVIDUAL","BUSINESS"]},"country":{"type":"string"},"taxIdType":{"type":"string","enum":["br_cpf","br_cnpj","us_ssn","us_ein","pt_nif","generic"]},"taxId":{"type":"string","minLength":4,"maxLength":40},"legalName":{"type":"string","minLength":2,"maxLength":160},"tradeName":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{6,14}$"},"addressLine1":{"type":"string","maxLength":200},"addressLine2":{"type":"string","maxLength":200},"city":{"type":"string","maxLength":120},"region":{"type":"string","maxLength":120},"postalCode":{"type":"string","maxLength":16},"addressCountry":{"type":"string"},"acceptTerms":{"type":"boolean"}}},"AddDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["ADMIN","FINANCE","DEVELOPER","SUPPORT"]}},"required":["email","role"]},"RoleDto":{"type":"object","properties":{"role":{"type":"string","nullable":true,"enum":["ADMIN","FINANCE","SUPPORT","RISK"]}},"required":["role"]},"PlayerIdDto":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"help":{"type":"string","nullable":true,"maxLength":200},"format":{"type":"string","enum":["TEXT","NUMBER","STEAM_TRADE_URL","STEAM_ID64"]}},"required":["label","format"]},"OwnerInputDto":{"type":"object","properties":{"type":{"type":"string","enum":["INDIVIDUAL","BUSINESS"]},"country":{"type":"string"}},"required":["type","country"]},"CreateProjectDto":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":60},"slug":{"type":"string"},"businessType":{"type":"string","enum":["GAME_SERVER","CREATOR","OTHER"]},"game":{"type":"string","enum":["OTHER","MINECRAFT","FIVEM","REDM","RUST","HYTALE"]},"platform":{"type":"string","enum":["MINECRAFT_JAVA","MINECRAFT_BEDROCK","MINECRAFT_OFFLINE","MINECRAFT_GEYSER","DEFAULT"]},"gameName":{"type":"string","minLength":2,"maxLength":40},"playerId":{"$ref":"#/components/schemas/PlayerIdDto"},"owner":{"$ref":"#/components/schemas/OwnerInputDto"}},"required":["name","slug","businessType"]},"UpdateProjectDto":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":60},"slug":{"type":"string"},"platform":{"type":"string","enum":["MINECRAFT_JAVA","MINECRAFT_BEDROCK","MINECRAFT_OFFLINE","MINECRAFT_GEYSER","DEFAULT"]},"supportEmail":{"type":"string","format":"email"},"gameName":{"type":"string","minLength":2,"maxLength":40}}},"UpdateSettingsDto":{"type":"object","properties":{"commandExpiryDays":{"type":"number","nullable":true,"minimum":1,"maximum":365},"alwaysAskRecipient":{"type":"boolean"},"giftingEnabled":{"type":"boolean"},"playerIdLabel":{"type":"string","minLength":1,"maxLength":40},"playerIdHelp":{"type":"string","nullable":true,"maxLength":200},"playerIdFormat":{"type":"string","enum":["TEXT","NUMBER","STEAM_TRADE_URL","STEAM_ID64"]},"refundPolicy":{"type":"string","enum":["NONE","UNCLAIMED_7_DAYS"]},"discountStacking":{"type":"string","enum":["PER_ITEM","CART_AFTER_AUTOMATIC","CART_BEFORE_AUTOMATIC"]},"checkoutMethods":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["PIX","PIX_AUTOMATIC","CARD","BOLETO"]}},"checkoutTheme":{"type":"string","nullable":true,"enum":["LIGHT","DARK","SYSTEM"]},"checkoutRadius":{"type":"string","nullable":true,"enum":["NONE","SM","MD","LG","FULL"]},"checkoutMessage":{"type":"string","nullable":true,"maxLength":500},"checkoutSuggestions":{"type":"boolean"},"checkoutLayout":{"type":"string","enum":["COMPACT","SPLIT"]}}},"CreateApiKeyDto":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":60},"permissions":{"type":"object","additionalProperties":true},"expiresAt":{"type":"string"}},"required":["name"]},"CreateCategoryDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"description":{"type":"string","maxLength":500},"imageUrl":{"type":"string","format":"uri"},"kind":{"type":"string","enum":["STANDARD","TIERED"]},"parentId":{"type":"string"}},"required":["name"]},"OrderCategoriesDto":{"type":"object","properties":{"parentId":{"type":"string","nullable":true},"categoryIds":{"maxItems":500,"type":"array","items":{"type":"string"}}},"required":["categoryIds"]},"UpdateCategoryDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"description":{"type":"string","nullable":true,"maxLength":500},"imageUrl":{"type":"string","nullable":true,"format":"uri"},"kind":{"type":"string","enum":["STANDARD","TIERED"]}}},"MoneyDto":{"type":"object","properties":{"amount":{"type":"number","minimum":0,"maximum":10000000000},"currency":{"type":"string","enum":["BRL"]}},"required":["amount"]},"CreateProductDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":5000},"sku":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,64}$"},"price":{"$ref":"#/components/schemas/MoneyDto"},"compareAt":{"$ref":"#/components/schemas/MoneyDto"},"imageUrl":{"type":"string","format":"uri"},"icon":{"type":"string","maxLength":60},"gallery":{"maxItems":10,"type":"array","items":{"type":"string","format":"uri"}},"videoUrl":{"type":"string","format":"uri"},"tags":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":30}},"accessDays":{"type":"number","nullable":true,"minimum":1,"maximum":3650},"categoryId":{"type":"string"},"featured":{"type":"boolean"},"listed":{"type":"boolean"},"badge":{"type":"string","nullable":true,"minLength":1,"maxLength":20},"accentColor":{"type":"string","nullable":true,"pattern":"^#[0-9a-fA-F]{6}$"},"visibleFrom":{"type":"string","nullable":true},"visibleUntil":{"type":"string","nullable":true},"requireLogin":{"type":"boolean"},"limitTotal":{"type":"number","nullable":true,"minimum":1,"maximum":1000000},"limitPerCustomer":{"type":"number","nullable":true,"minimum":1,"maximum":1000000},"limitCountsExpired":{"type":"boolean"},"singleQuantity":{"type":"boolean"},"giftCardValue":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"giftCardDays":{"type":"number","nullable":true,"minimum":1,"maximum":3650},"acceptsGiftCard":{"type":"boolean"},"giftable":{"type":"boolean"}},"required":["name","description","price"]},"OrderProductsDto":{"type":"object","properties":{"categoryId":{"type":"string","nullable":true},"productIds":{"maxItems":1000,"type":"array","items":{"type":"string"}}},"required":["productIds"]},"UpdateProductDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":5000},"sku":{"type":"string","nullable":true,"pattern":"^[A-Za-z0-9._-]{1,64}$"},"imageUrl":{"type":"string","nullable":true,"format":"uri"},"icon":{"type":"string","nullable":true,"maxLength":60},"gallery":{"maxItems":10,"type":"array","items":{"type":"string","format":"uri"}},"videoUrl":{"type":"string","nullable":true,"format":"uri"},"tags":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":30}},"accessDays":{"type":"number","nullable":true,"minimum":1,"maximum":3650},"categoryId":{"type":"string","nullable":true},"featured":{"type":"boolean"},"listed":{"type":"boolean"},"badge":{"type":"string","nullable":true,"minLength":1,"maxLength":20},"accentColor":{"type":"string","nullable":true,"pattern":"^#[0-9a-fA-F]{6}$"},"visibleFrom":{"type":"string","nullable":true},"visibleUntil":{"type":"string","nullable":true},"requireLogin":{"type":"boolean"},"limitTotal":{"type":"number","nullable":true,"minimum":1,"maximum":1000000},"limitPerCustomer":{"type":"number","nullable":true,"minimum":1,"maximum":1000000},"limitCountsExpired":{"type":"boolean"},"singleQuantity":{"type":"boolean"},"giftCardValue":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"giftCardDays":{"type":"number","nullable":true,"minimum":1,"maximum":3650},"acceptsGiftCard":{"type":"boolean"},"giftable":{"type":"boolean"},"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]}}},"RequirementsDto":{"type":"object","properties":{"productIds":{"uniqueItems":true,"maxItems":20,"type":"array","items":{"type":"string"}},"requiresAll":{"type":"boolean"}},"required":["productIds","requiresAll"]},"UpsellsDto":{"type":"object","properties":{"productIds":{"uniqueItems":true,"maxItems":5,"type":"array","items":{"type":"string"}}},"required":["productIds"]},"CreatePriceDto":{"type":"object","properties":{"type":{"type":"string","enum":["ONE_TIME","RECURRING"]},"amount":{"$ref":"#/components/schemas/MoneyDto"},"compareAt":{"$ref":"#/components/schemas/MoneyDto"},"interval":{"type":"string","enum":["YEAR","WEEK","DAY","MONTH"]},"intervalCount":{"type":"number","minimum":1,"maximum":12},"makeDefault":{"type":"boolean"}},"required":["type","amount"]},"UpdatePriceDto":{"type":"object","properties":{"active":{"type":"boolean"}},"required":["active"]},"ImportLicenseKeysDto":{"type":"object","properties":{"keys":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","maxLength":500,"minLength":1}}},"required":["keys"]},"CreateFileDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"contentType":{"type":"string","pattern":"^[\\w.+-]+\\/[\\w.+-]+$"},"sizeBytes":{"type":"number","minimum":1,"maximum":104857600}},"required":["name","contentType","sizeBytes"]},"CreateDiscountDto":{"type":"object","properties":{"method":{"type":"string","enum":["AUTOMATIC","CODE"]},"code":{"type":"string","pattern":"^[A-Z0-9_-]{3,32}$"},"name":{"type":"string","minLength":1,"maxLength":60},"kind":{"type":"string","enum":["PERCENT","FIXED"]},"value":{"type":"number","minimum":1,"maximum":2147483647},"scope":{"type":"string","enum":["ALL","CATEGORIES","PRODUCTS"]},"categoryIds":{"uniqueItems":true,"maxItems":100,"type":"array","items":{"type":"string"}},"productIds":{"uniqueItems":true,"maxItems":500,"type":"array","items":{"type":"string"}},"startsAt":{"type":"string","nullable":true},"endsAt":{"type":"string","nullable":true},"maxUses":{"type":"number","nullable":true,"minimum":1,"maximum":2147483647},"maxUsesPerCustomer":{"type":"number","nullable":true,"minimum":1,"maximum":2147483647},"minSubtotal":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"customerId":{"type":"string","nullable":true},"requiredProductIds":{"uniqueItems":true,"maxItems":50,"type":"array","items":{"type":"string"}},"startCommands":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":500}},"endCommands":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":500}},"active":{"type":"boolean"}},"required":["method","name","kind","value"]},"UpdateDiscountDto":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z0-9_-]{3,32}$"},"name":{"type":"string","minLength":1,"maxLength":60},"kind":{"type":"string","enum":["PERCENT","FIXED"]},"value":{"type":"number","minimum":1,"maximum":2147483647},"scope":{"type":"string","enum":["ALL","CATEGORIES","PRODUCTS"]},"categoryIds":{"uniqueItems":true,"maxItems":100,"type":"array","items":{"type":"string"}},"productIds":{"uniqueItems":true,"maxItems":500,"type":"array","items":{"type":"string"}},"startsAt":{"type":"string","nullable":true},"endsAt":{"type":"string","nullable":true},"maxUses":{"type":"number","nullable":true,"minimum":1,"maximum":2147483647},"maxUsesPerCustomer":{"type":"number","nullable":true,"minimum":1,"maximum":2147483647},"minSubtotal":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/MoneyDto"}]},"customerId":{"type":"string","nullable":true},"requiredProductIds":{"uniqueItems":true,"maxItems":50,"type":"array","items":{"type":"string"}},"startCommands":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":500}},"endCommands":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":500}},"active":{"type":"boolean"}}},"CreateCustomerDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"name":{"type":"string","minLength":1,"maxLength":120},"taxId":{"type":"string","pattern":"^(\\d{11}|\\d{14})$"},"phone":{"type":"string","pattern":"^\\+?\\d{10,15}$"}}},"UpdateCustomerDto":{"type":"object","properties":{"email":{"type":"string","nullable":true,"format":"email"},"name":{"type":"string","nullable":true,"minLength":1,"maxLength":120},"taxId":{"type":"string","nullable":true,"pattern":"^(\\d{11}|\\d{14})$"},"phone":{"type":"string","nullable":true,"pattern":"^\\+?\\d{10,15}$"}}},"AddIdentityDto":{"type":"object","properties":{"kind":{"type":"string","enum":["DISCORD","MINECRAFT_UUID","MINECRAFT_NAME","EMAIL","GAME_ACCOUNT"]},"value":{"type":"string","minLength":1,"maxLength":200},"displayName":{"type":"string","maxLength":60}},"required":["kind","value"]},"CreateBanDto":{"type":"object","properties":{"kind":{"type":"string","enum":["DISCORD","EMAIL","PLAYER","IP"]},"value":{"type":"string","minLength":1,"maxLength":200},"reason":{"type":"string","enum":["MANUAL","DISPUTE","FRAUD"]},"note":{"type":"string","maxLength":500}},"required":["kind","value"]},"SaveDraftDto":{"type":"object","properties":{"draft":{"type":"object","additionalProperties":true}},"required":["draft"]},"CreateStorefrontDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"kind":{"type":"string","enum":["IN_GAME","LANDING","COLLECTION"]},"draft":{"type":"object","additionalProperties":true}},"required":["name","kind"]},"ImportStorefrontDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"kind":{"type":"string","enum":["IN_GAME","LANDING","COLLECTION"]},"draft":{"type":"object","additionalProperties":true}},"required":["name","draft"]},"UpdateStorefrontDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"kind":{"type":"string","enum":["IN_GAME","LANDING","COLLECTION"]},"draft":{"type":"object","additionalProperties":true}}},"DuplicateStorefrontDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60}}},"GiftCardBalanceDto":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":32}},"required":["code"]},"RecipientDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200}},"required":["name"]},"CreateCartDto":{"type":"object","properties":{"project":{"type":"string","pattern":"^[a-z0-9-]{3,32}$"},"recipient":{"$ref":"#/components/schemas/RecipientDto"},"completeUrl":{"type":"string","format":"uri"},"cancelUrl":{"type":"string","format":"uri"},"metadata":{"type":"object","additionalProperties":true},"creatorCode":{"type":"string","minLength":1,"maxLength":64},"giftCardCode":{"type":"string","minLength":1,"maxLength":32}},"required":["project"]},"AddItemDto":{"type":"object","properties":{"productId":{"type":"string"},"quantity":{"type":"number","minimum":1,"maximum":100},"options":{"type":"object","additionalProperties":true}},"required":["productId","quantity"]},"GiftDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"message":{"type":"string","minLength":0,"maxLength":500}},"required":["name"]},"AddGiftDto":{"type":"object","properties":{"productId":{"type":"string"},"quantity":{"type":"number","minimum":1,"maximum":100},"options":{"type":"object","additionalProperties":true},"gift":{"$ref":"#/components/schemas/GiftDto"}},"required":["productId","quantity","gift"]},"UpdateItemDto":{"type":"object","properties":{"quantity":{"type":"number","minimum":1,"maximum":100}},"required":["quantity"]},"DiscountCodeDto":{"type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":32}},"required":["code"]},"CreatorCodeDto":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":64}},"required":["code"]},"SubscribeDto":{"type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":64}},"required":["productId"]},"SetDomainDto":{"type":"object","properties":{"hostname":{"type":"string","minLength":4,"maxLength":253}},"required":["hostname"]},"OrderItemInputDto":{"type":"object","properties":{"productId":{"type":"string"},"quantity":{"type":"number","minimum":1,"maximum":100}},"required":["productId","quantity"]},"OrderCustomerDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"name":{"type":"string","minLength":1,"maxLength":120}},"required":["email"]},"OrderRecipientDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200}},"required":["name"]},"CreateApiOrderDto":{"type":"object","properties":{"items":{"minItems":1,"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/OrderItemInputDto"}},"customer":{"$ref":"#/components/schemas/OrderCustomerDto"},"recipient":{"$ref":"#/components/schemas/OrderRecipientDto"},"externalId":{"type":"string","minLength":1,"maxLength":100},"metadata":{"type":"object","additionalProperties":true},"successUrl":{"type":"string","format":"uri"},"cancelUrl":{"type":"string","format":"uri"},"expiresInMinutes":{"type":"number","minimum":5,"maximum":10080},"allowedMethods":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["PIX","PIX_AUTOMATIC","CARD","BOLETO"]}}},"required":["items"]},"CreateManualOrderDto":{"type":"object","properties":{"items":{"minItems":1,"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/OrderItemInputDto"}},"recipient":{"$ref":"#/components/schemas/OrderRecipientDto"},"customerId":{"type":"string"},"note":{"type":"string","minLength":1,"maxLength":500}},"required":["items","note"]},"ActivateDto":{"type":"object","properties":{"termsVersion":{"type":"string","minLength":1,"maxLength":40}},"required":["termsVersion"]},"EnabledDto":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]},"RefundPixKeyDto":{"type":"object","properties":{"type":{"enum":["CPF","CNPJ","EMAIL","PHONE","RANDOM"],"type":"string"},"key":{"type":"string","minLength":1,"maxLength":77}},"required":["type","key"]},"CreateRefundDto":{"type":"object","properties":{"amount":{"type":"number","minimum":1},"reason":{"type":"string","maxLength":200},"pixKey":{"$ref":"#/components/schemas/RefundPixKeyDto"}}},"EvidenceFileDto":{"type":"object","properties":{"contentType":{"type":"string","enum":["application/pdf","image/png","image/jpeg"]},"sizeBytes":{"type":"number","minimum":1,"maximum":10485760}},"required":["contentType","sizeBytes"]},"EvidenceDto":{"type":"object","properties":{"description":{"type":"string","minLength":1,"maxLength":2000},"url":{"type":"string","format":"uri"},"file":{"$ref":"#/components/schemas/EvidenceFileDto"}},"required":["description"]},"BankDto":{"type":"object","properties":{"ispb":{"type":"string","pattern":"^\\d{8}$"},"branch":{"type":"string","pattern":"^\\d{1,4}$"},"account":{"type":"string","pattern":"^\\d{1,20}$"},"accountType":{"type":"string","enum":["CACC","TRAN","SVGS"]}},"required":["ispb","branch","account","accountType"]},"CreateDto":{"type":"object","properties":{"priceId":{"type":"string"},"customer":{"$ref":"#/components/schemas/CustomerDto"},"recipient":{"$ref":"#/components/schemas/RecipientDto"}},"required":["priceId","customer"]},"CodeDto":{"type":"object","properties":{"code":{"type":"string","pattern":"^\\d{6}$"}},"required":["code"]},"PatchDto":{"type":"object","properties":{"isDefault":{"type":"boolean"}},"required":["isDefault"]},"RequestDto":{"type":"object","properties":{"amount":{"type":"number","minimum":1},"payoutAccountId":{"type":"string"}},"required":["amount"]},"ApproveDto":{"type":"object","properties":{"legalName":{"type":"string","minLength":2,"maxLength":160},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["reason"]},"ReasonDto":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["reason"]},"StaffRefundDto":{"type":"object","properties":{"pixKey":{"$ref":"#/components/schemas/RefundPixKeyDto"}}},"ResolveDto":{"type":"object","properties":{"outcome":{"type":"string","enum":["PAID","FAILED"]},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["outcome","reason"]},"PostingDto":{"type":"object","properties":{"account":{"type":"string","minLength":1,"maxLength":120},"amount":{"type":"number"}},"required":["account","amount"]},"AdjustmentDto":{"type":"object","properties":{"postings":{"minItems":2,"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/PostingDto"}},"reason":{"type":"string","minLength":3,"maxLength":500},"reference":{"type":"string","minLength":1,"maxLength":120}},"required":["postings","reason"]},"PlanDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"isDefault":{"type":"boolean"}},"required":["name"]},"RateDto":{"type":"object","properties":{"operation":{"type":"string","enum":["PAYOUT","PAYMENT","DISPUTE","PAYOUT_ACCOUNT_VERIFICATION"]},"method":{"type":"string","enum":["PIX","PIX_AUTOMATIC","CARD","BOLETO"]},"conditions":{"type":"object","additionalProperties":true},"percentBps":{"type":"number","minimum":0,"maximum":10000},"fixedCents":{"type":"number","minimum":0}},"required":["operation","percentBps","fixedCents"]},"SettingsDto":{"type":"object","properties":{"pricingPlanId":{"type":"string","nullable":true}}},"AccountSettingsDto":{"type":"object","properties":{"payoutDayLimitCents":{"type":"number","nullable":true,"minimum":0},"payoutNightLimitCents":{"type":"number","nullable":true,"minimum":0},"payoutReviewThresholdCents":{"type":"number","nullable":true,"minimum":0},"payoutPricingPlanId":{"type":"string","nullable":true}}},"MethodDto":{"type":"object","properties":{"adminBlocked":{"type":"boolean"},"adminBlockedReason":{"type":"string","minLength":3,"maxLength":200},"releaseDays":{"type":"number","nullable":true,"minimum":0,"maximum":120},"volumeCapCents":{"type":"number","nullable":true,"minimum":0},"capExempt":{"type":"boolean"},"settings":{"type":"object","additionalProperties":true}}},"MemberDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["ADMIN","FINANCE","SUPPORT","RISK"]}},"required":["email","role"]},"BanDto":{"type":"object","properties":{"ip":{"type":"string"},"reason":{"type":"string","minLength":3,"maxLength":300}},"required":["ip","reason"]},"SettleDto":{"type":"object","properties":{"payOrder":{"type":"boolean"}},"required":["payOrder"]},"ReturnDto":{"type":"object","properties":{"address":{"type":"string","minLength":1,"maxLength":100},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["address"]},"ResolveReturnDto":{"type":"object","properties":{"txHash":{"type":"string","minLength":1,"maxLength":100}}},"MainWalletDto":{"type":"object","properties":{"network":{"type":"string","enum":["POLYGON","BASE"]}},"required":["network"]},"LinkItemDto":{"type":"object","properties":{"productId":{"type":"string"},"priceId":{"type":"string"},"quantity":{"type":"number","minimum":1,"maximum":100}},"required":["quantity"]},"CreateLinkDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"items":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/LinkItemDto"}},"askRecipient":{"type":"boolean"},"successUrl":{"type":"string","format":"uri"}},"required":["name","items"]},"PatchLinkDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"active":{"type":"boolean"},"askRecipient":{"type":"boolean"},"successUrl":{"type":"string","nullable":true,"format":"uri"}}},"CustomerDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"name":{"type":"string","minLength":1,"maxLength":120}},"required":["email"]},"LinkOrderDto":{"type":"object","properties":{"recipient":{"$ref":"#/components/schemas/RecipientDto"},"customer":{"$ref":"#/components/schemas/CustomerDto"}}},"VisitDto":{"type":"object","properties":{"orderId":{"type":"string"},"paymentLinkId":{"type":"string"}}},"CancelDto":{"type":"object","properties":{"atPeriodEnd":{"type":"boolean"},"reason":{"type":"string","minLength":1,"maxLength":200}}},"PortalCancelDto":{"type":"object","properties":{"reason":{"type":"string","enum":["too_expensive","not_using","technical","switching","other"]},"comment":{"type":"string","maxLength":500}}},"IdentifyDto":{"type":"object","properties":{"email":{"type":"string","format":"email"},"name":{"type":"string","minLength":1,"maxLength":120}},"required":["email"]},"SetRecipientDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200}},"required":["name"]},"CheckoutDiscountDto":{"type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":32}},"required":["code"]},"GiftRecipientDto":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email"},"name":{"type":"string","minLength":1,"maxLength":80},"message":{"type":"string","minLength":1,"maxLength":200}},"required":["email"]},"CheckoutCreatorDto":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":64}},"required":["code"]},"AddCheckoutItemDto":{"type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":64},"quantity":{"type":"number","minimum":1,"maximum":99}},"required":["productId"]},"PayerAddressDto":{"type":"object","properties":{"zipcode":{"type":"string","minLength":8,"maxLength":9},"street":{"type":"string","minLength":1,"maxLength":120},"number":{"type":"string","minLength":1,"maxLength":20},"complement":{"type":"string","maxLength":60},"neighborhood":{"type":"string","minLength":1,"maxLength":80},"city":{"type":"string","minLength":1,"maxLength":80},"state":{"type":"string","minLength":2,"maxLength":2}},"required":["zipcode","street","number","neighborhood","city","state"]},"PayerDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"taxId":{"type":"string","pattern":"^\\d{11}$|^\\d{14}$|^[\\d.\\-/]{11,18}$"},"address":{"$ref":"#/components/schemas/PayerAddressDto"}},"required":["name","taxId"]},"CryptoChoiceDto":{"type":"object","properties":{"asset":{"type":"string","enum":["USDC","USDT"]},"network":{"type":"string","enum":["POLYGON","BASE"]}},"required":["asset","network"]},"StartPaymentDto":{"type":"object","properties":{"method":{"type":"string","enum":["PIX","PIX_AUTOMATIC","CARD","BOLETO"]},"confirmationTokenId":{"type":"string","pattern":"^ctoken_[A-Za-z0-9]+$"},"turnstileToken":{"type":"string","maxLength":2048},"payer":{"$ref":"#/components/schemas/PayerDto"},"crypto":{"$ref":"#/components/schemas/CryptoChoiceDto"}},"required":["method"]},"MediaDto":{"type":"object","properties":{"contentType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"data":{"type":"string","maxLength":2796211},"name":{"type":"string","maxLength":255}},"required":["contentType","data"]},"ConnectDto":{"type":"object","properties":{"code":{"type":"string"},"guildId":{"type":"string","pattern":"^\\d{15,21}$"},"state":{"type":"string"}},"required":["code","guildId","state"]},"GuildPatchDto":{"type":"object","properties":{"logChannelId":{"type":"string","nullable":true,"pattern":"^\\d{15,21}$"},"saleChannelId":{"type":"string","nullable":true,"pattern":"^\\d{15,21}$"},"saleMessage":{"type":"string","nullable":true,"maxLength":500}}},"GuildTestDto":{"type":"object","properties":{"channel":{"type":"string","enum":["sale","staff"]}},"required":["channel"]},"CreateConnectionDto":{"type":"object","properties":{"type":{"type":"string","enum":["MINECRAFT","FIVEM","REDM","RUST","HYTALE"]},"name":{"type":"string","minLength":1,"maxLength":60}},"required":["type","name"]},"UpdateConnectionDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60}},"required":["name"]},"ClaimPairingDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"connectionId":{"type":"string"}}},"AgentServerDetailsDto":{"type":"object","properties":{"game":{"type":"string","enum":["MINECRAFT_JAVA","RUST","ARK_SE","ARK_SA","CONAN","PALWORLD","SEVEN_DAYS","HYTALE","SOURCE_GENERIC"]},"gameVersion":{"type":"string","maxLength":32},"motd":{"type":"string","maxLength":4096},"port":{"type":"number","minimum":1,"maximum":65535}}},"CreatePairingDto":{"type":"object","properties":{"type":{"type":"string","enum":["MINECRAFT","FIVEM","REDM","RUST","HYTALE","GAME_AGENT"]},"agentVersion":{"type":"string","maxLength":32},"lookupHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"keyHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"server":{"$ref":"#/components/schemas/AgentServerDetailsDto"}},"required":["type","agentVersion","lookupHash","keyHash"]},"HeartbeatDto":{"type":"object","properties":{"agentVersion":{"type":"string","maxLength":32},"details":{"type":"object","additionalProperties":true}},"required":["agentVersion"]},"AgentItemDto":{"type":"object","properties":{"sku":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,64}$"},"quantity":{"type":"number","minimum":1,"maximum":100},"giftTo":{"type":"string","minLength":1,"maxLength":32}},"required":["sku","quantity"]},"AgentRecipientDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":32},"uuid":{"type":"string","pattern":"^[0-9a-fA-F-]{32,36}$"}},"required":["name"]},"AgentOrderDto":{"type":"object","properties":{"items":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/AgentItemDto"}},"recipient":{"$ref":"#/components/schemas/AgentRecipientDto"},"discountCode":{"type":"string","minLength":3,"maxLength":32},"method":{"type":"string","enum":["PIX","PIX_AUTOMATIC","CARD","BOLETO"]}},"required":["items","recipient","method"]},"Object":{"type":"object","properties":{}},"OnlinePlayerDto":{"type":"object","properties":{"uuid":{"type":"string","pattern":"^[0-9a-fA-F-]{32,36}$"},"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,64}$"},"name":{"type":"string","minLength":1,"maxLength":64},"freeSlots":{"type":"number","minimum":0,"maximum":36}},"required":["name"]},"CommandsPollDto":{"type":"object","properties":{"wait":{"type":"object","default":25,"minimum":0,"maximum":30},"limit":{"type":"object","default":50,"minimum":1,"maximum":100},"players":{"maxItems":2000,"type":"array","items":{"$ref":"#/components/schemas/OnlinePlayerDto"}}},"required":["wait","limit"]},"AckResultDto":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["ok","failed"]},"error":{"type":"string","maxLength":500},"output":{"type":"string","maxLength":20000}},"required":["id","status"]},"AckDto":{"type":"object","properties":{"ids":{"uniqueItems":true,"minItems":1,"maxItems":100,"type":"array","items":{"type":"string"}},"results":{"minItems":1,"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/AckResultDto"}}}},"CreateCloudAgentDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"game":{"type":"string","enum":["MINECRAFT_JAVA","RUST","ARK_SE","ARK_SA","CONAN","PALWORLD","SEVEN_DAYS","HYTALE","SOURCE_GENERIC"]},"host":{"type":"string","minLength":1,"maxLength":253},"port":{"type":"number","minimum":1,"maximum":65535},"password":{"type":"string","minLength":1,"maxLength":200}},"required":["name","game","host","port","password"]},"UpdateCloudAgentDto":{"type":"object","properties":{"host":{"type":"string","minLength":1,"maxLength":253},"port":{"type":"number","minimum":1,"maximum":65535},"password":{"type":"string","minLength":1,"maxLength":200}}},"CreateActionDto":{"type":"object","properties":{"type":{"enum":["MANUAL","COMMAND","DISCORD_ROLE","FILE","LICENSE_KEY"],"type":"string"},"trigger":{"enum":["REFUNDED","REMOVED","PURCHASED","RENEWED","DISPUTED"],"type":"string"},"config":{"type":"object"},"connectionIds":{"maxItems":50,"type":"array","items":{"type":"string"}},"sortOrder":{"type":"number","minimum":0,"maximum":1000}},"required":["type","trigger","config"]},"UpdateActionDto":{"type":"object","properties":{"trigger":{"enum":["REFUNDED","REMOVED","PURCHASED","RENEWED","DISPUTED"],"type":"string"},"config":{"type":"object"},"connectionIds":{"maxItems":50,"type":"array","items":{"type":"string"}},"sortOrder":{"type":"number","minimum":0,"maximum":1000}}},"TestRecipientDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200}},"required":["name"]},"TestCommandDto":{"type":"object","properties":{"connectionId":{"type":"string"},"command":{"type":"string","minLength":1,"maxLength":500},"recipient":{"$ref":"#/components/schemas/TestRecipientDto"}},"required":["connectionId","command"]},"ResendDto":{"type":"object","properties":{"connectionId":{"type":"string"},"productIds":{"maxItems":200,"type":"array","items":{"type":"string"}},"from":{"type":"string"},"to":{"type":"string"},"dryRun":{"type":"boolean"}},"required":["connectionId"]},"CreateEndpointDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"url":{"type":"string","maxLength":2048},"events":{"maxItems":50,"type":"array","items":{"type":"string"}}},"required":["name","url"]},"UpdateEndpointDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"url":{"type":"string","maxLength":2048},"events":{"maxItems":50,"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["ACTIVE","DISABLED"]}}},"AuthorizeDecisionDto":{"type":"object","properties":{"clientId":{"type":"string","maxLength":128},"redirectUri":{"type":"string","maxLength":2048},"scope":{"type":"string","maxLength":512},"state":{"type":"string","maxLength":2048},"codeChallenge":{"type":"string","maxLength":256},"codeChallengeMethod":{"type":"string","enum":["S256"]},"resource":{"type":"string","maxLength":2048},"approve":{"type":"boolean"},"scopes":{"maxItems":20,"type":"array","items":{"type":"string"}},"allProjects":{"type":"boolean"},"projectIds":{"maxItems":200,"type":"array","items":{"type":"string"}}},"required":["clientId","redirectUri","codeChallenge","codeChallengeMethod","approve","scopes","allProjects","projectIds"]},"CreateCreatorDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"code":{"type":"string","pattern":"^[A-Z0-9_-]{3,32}$"},"commissionBps":{"type":"number","minimum":100,"maximum":5000},"discountBps":{"type":"number","minimum":0,"maximum":5000},"contact":{"type":"string","nullable":true,"minLength":0,"maxLength":120},"active":{"type":"boolean"}},"required":["name","code"]},"UpdateCreatorDto":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"code":{"type":"string","pattern":"^[A-Z0-9_-]{3,32}$"},"commissionBps":{"type":"number","minimum":100,"maximum":5000},"discountBps":{"type":"number","minimum":0,"maximum":5000},"contact":{"type":"string","nullable":true,"minLength":0,"maxLength":120},"active":{"type":"boolean"}}},"CreatePayoutDto":{"type":"object","properties":{"amountCents":{"type":"number","minimum":1},"paidAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"note":{"type":"string","minLength":0,"maxLength":200}},"required":["amountCents","paidAt"]},"TokenDto":{"type":"object","properties":{"token":{"type":"string","minLength":10,"maxLength":2000}},"required":["token"]},"RecoverySettingsDto":{"type":"object","properties":{"recoveryEnabled":{"type":"boolean"},"recoveryDelayMinutes":{"type":"number","minimum":60,"maximum":1440},"recoveryDiscountBps":{"type":"number","minimum":0,"maximum":5000},"followUpEnabled":{"type":"boolean"},"followUpDelayHours":{"type":"number","minimum":1,"maximum":168},"followUpDiscountBps":{"type":"number","minimum":0,"maximum":5000},"followUpCouponDays":{"type":"number","minimum":1,"maximum":30}}},"GoalDto":{"type":"object","properties":{"active":{"type":"boolean"},"targetCents":{"type":"number","minimum":100},"period":{"type":"string","enum":["MONTHLY","REPEATING"]},"productIds":{"maxItems":200,"type":"array","items":{"type":"string"}},"showAmount":{"type":"boolean"},"commands":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":500}},"discordMessage":{"type":"string","nullable":true,"maxLength":500},"saleBps":{"type":"number","minimum":0,"maximum":5000},"saleHours":{"type":"number","minimum":1,"maximum":168}},"required":["active","targetCents","period","productIds","showAmount","commands","saleBps","saleHours"]},"CreateGiftCardDto":{"type":"object","properties":{"amountCents":{"type":"number","minimum":100,"maximum":1000000},"expiresAt":{"type":"string","nullable":true},"note":{"type":"string","maxLength":200},"recipientEmail":{"type":"string","maxLength":254,"format":"email"},"recipientName":{"type":"string","minLength":1,"maxLength":80},"message":{"type":"string","minLength":1,"maxLength":200}},"required":["amountCents"]},"BatchDto":{"type":"object","properties":{"count":{"type":"number","minimum":1,"maximum":500},"amountCents":{"type":"number","minimum":100,"maximum":1000000},"expiresAt":{"type":"string","nullable":true},"note":{"type":"string","maxLength":200}},"required":["count","amountCents"]},"TopUpDto":{"type":"object","properties":{"amountCents":{"type":"number","minimum":100,"maximum":1000000}},"required":["amountCents"]},"UpdateGiftCardDto":{"type":"object","properties":{"status":{"type":"string","enum":["ACTIVE","DISABLED"]},"note":{"type":"string","nullable":true,"maxLength":200},"expiresAt":{"type":"string","nullable":true}}},"CreditDto":{"type":"object","properties":{"amountCents":{"type":"number","minimum":100,"maximum":1000000}},"required":["amountCents"]},"Problem":{"type":"object","required":["type","title","status","code"],"properties":{"type":{"type":"string","format":"uri","description":"Link para a explicação do código em docs.rivoo.gg."},"title":{"type":"string","description":"Texto para gente. Pode mudar: use `code`."},"status":{"type":"integer"},"code":{"type":"string","description":"Código estável, em snake_case."},"detail":{"type":"string"},"errors":{"type":"array","description":"Um item por campo inválido (só em `validation_failed` e erros de itens).","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"requestId":{"type":"string","description":"Mande ao suporte quando precisar de ajuda com a chamada."}}}}}}