{
  "openapi": "3.0.3",
  "info": {
    "title": "Credidoc API",
    "version": "1.5.0",
    "description": "API para tomadores de plantões médicos: escala, ponto, validação, cessões, folhas e webhooks.",
    "contact": {
      "name": "Integrações Credidoc",
      "email": "integracoes@credidoc.com.br"
    }
  },
  "servers": [
    {
      "url": "https://api.credidoc.com.br/v1",
      "description": "Produção"
    },
    {
      "url": "https://sandbox.api.credidoc.com.br/v1",
      "description": "Sandbox"
    }
  ],
  "security": [
    {
      "chave": []
    }
  ],
  "paths": {
    "/plantoes": {
      "get": {
        "tags": [
          "Plantões"
        ],
        "summary": "Listar plantões",
        "description": "Lista os plantões do tomador, mais recentes primeiro.",
        "operationId": "plantoes_listar",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "pending, validated, advanced, paid, glosa, late"
          },
          {
            "name": "competencia",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Mês no formato AAAA-MM"
          },
          {
            "name": "medico_crm",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "CRM do médico"
          },
          {
            "name": "confere",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Só plantões cujas batidas conferem com a escala"
          },
          {
            "name": "limite",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "De 1 a 200. Padrão 50"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Valor de proximo_cursor da página anterior"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "dados": [
                    {
                      "id": "P-1084",
                      "status": "pending",
                      "medico": {
                        "crm": "123456",
                        "uf": "SP",
                        "nome": "Ana Ribeiro"
                      },
                      "setor": "Pronto-socorro adulto",
                      "inicio": "2026-10-01T07:00:00-03:00",
                      "fim": "2026-10-01T19:00:00-03:00",
                      "horas": 12,
                      "valor": "1200.00",
                      "folha": "2026-12-26",
                      "batidas": {
                        "entrada": "2026-10-01T06:52:11-03:00",
                        "saida": "2026-10-01T19:04:38-03:00",
                        "origem": "pontomais"
                      },
                      "confere": true,
                      "criado_em": "2026-10-01T19:05:02-03:00"
                    }
                  ],
                  "proximo_cursor": "eyJpZCI6IlAtMTA4MyJ9"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      },
      "post": {
        "tags": [
          "Plantões"
        ],
        "summary": "Enviar escala",
        "description": "Cria ou atualiza até 500 plantões por chamada. Plantões com o mesmo id são atualizados enquanto não forem validados.",
        "operationId": "plantoes_enviarEscala",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "recebidos": 1,
                  "criados": 1,
                  "atualizados": 0,
                  "recusados": []
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "competencia": "2026-10",
                "plantoes": [
                  {
                    "id": "P-1084",
                    "medico": {
                      "crm": "123456",
                      "uf": "SP"
                    },
                    "setor": "Pronto-socorro adulto",
                    "inicio": "2026-10-01T07:00:00-03:00",
                    "fim": "2026-10-01T19:00:00-03:00",
                    "valor": "1200.00"
                  }
                ]
              }
            }
          }
        }
      }
    },
    "/plantoes/{id}": {
      "get": {
        "tags": [
          "Plantões"
        ],
        "summary": "Consultar plantão",
        "description": "Retorna um plantão com batidas, glosa e cessão, quando houver.",
        "operationId": "plantoes_consultar",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Identificador do plantão"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "id": "P-1084",
                  "status": "pending",
                  "medico": {
                    "crm": "123456",
                    "uf": "SP",
                    "nome": "Ana Ribeiro"
                  },
                  "setor": "Pronto-socorro adulto",
                  "inicio": "2026-10-01T07:00:00-03:00",
                  "fim": "2026-10-01T19:00:00-03:00",
                  "horas": 12,
                  "valor": "1200.00",
                  "folha": "2026-12-26",
                  "batidas": {
                    "entrada": "2026-10-01T06:52:11-03:00",
                    "saida": "2026-10-01T19:04:38-03:00",
                    "origem": "pontomais"
                  },
                  "confere": true,
                  "criado_em": "2026-10-01T19:05:02-03:00"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/plantoes/validar": {
      "post": {
        "tags": [
          "Plantões"
        ],
        "summary": "Validar em lote",
        "description": "Valida plantões. Assim que validado, o valor fica disponível para o médico antecipar.",
        "operationId": "plantoes_validar",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "validados": 3,
                  "ignorados": []
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "ids": [
                  "P-1084",
                  "P-1085",
                  "P-1086"
                ],
                "validado_por": "patricia.gomes@saolucas.org.br"
              }
            }
          }
        }
      }
    },
    "/plantoes/{id}/glosar": {
      "post": {
        "tags": [
          "Plantões"
        ],
        "summary": "Glosar plantão",
        "description": "Registra glosa total ou parcial. O médico é avisado e pode contestar em 15 dias.",
        "operationId": "plantoes_glosar",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Plantão"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "id": "P-1084",
                  "status": "glosa",
                  "glosa": {
                    "tipo": "parcial",
                    "valor": "600.00",
                    "em": "2026-10-27T10:12:00-03:00"
                  }
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "tipo": "parcial",
                "valor": "600.00",
                "motivo": "Saída antecipada",
                "observacao": "Saiu às 13h com autorização da coordenação"
              }
            }
          }
        }
      }
    },
    "/plantoes/{id}/ajustar": {
      "post": {
        "tags": [
          "Plantões"
        ],
        "summary": "Ajustar valor ou horário",
        "description": "Corrige um plantão ainda não antecipado. A alteração fica no histórico com antes e depois.",
        "operationId": "plantoes_ajustar",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Plantão"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "id": "P-1084",
                  "valor": "1350.00",
                  "ajustado_em": "2026-10-27T10:15:00-03:00"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "valor": "1350.00",
                "fim": "2026-10-01T20:30:00-03:00",
                "motivo": "Hora extra autorizada"
              }
            }
          }
        }
      }
    },
    "/batidas": {
      "post": {
        "tags": [
          "Batidas de ponto"
        ],
        "summary": "Enviar batidas",
        "description": "Recebe até 2.000 marcações por chamada. A Credidoc casa cada batida com o plantão do médico pelo CRM e horário, com a tolerância configurada no portal.",
        "operationId": "batidas_enviar",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "recebidas": 2,
                  "casadas": 2,
                  "sem_plantao": []
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "origem": "ahgora",
                "batidas": [
                  {
                    "crm": "123456",
                    "uf": "SP",
                    "tipo": "entrada",
                    "em": "2026-10-01T06:52:11-03:00",
                    "dispositivo": "REP-0042"
                  },
                  {
                    "crm": "123456",
                    "uf": "SP",
                    "tipo": "saida",
                    "em": "2026-10-01T19:04:38-03:00",
                    "dispositivo": "REP-0042"
                  }
                ]
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Batidas de ponto"
        ],
        "summary": "Listar batidas",
        "description": "Consulta as marcações recebidas e o plantão associado.",
        "operationId": "batidas_listar",
        "parameters": [
          {
            "name": "data",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Dia das marcações"
          },
          {
            "name": "crm",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "CRM do médico"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "dados": [
                    {
                      "crm": "123456",
                      "tipo": "entrada",
                      "em": "2026-10-01T06:52:11-03:00",
                      "plantao": "P-1084",
                      "origem": "ahgora"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/importacoes": {
      "post": {
        "tags": [
          "Importações"
        ],
        "summary": "Importar arquivo",
        "description": "Envie multipart/form-data com o campo arquivo. Aceita escala e ponto (CSV ou XML no DTD escala) e folha (CSV ou XML no DTD folha). O processamento é assíncrono.",
        "operationId": "importacoes_enviar",
        "responses": {
          "202": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "id": "imp_01JBX9Q2",
                  "status": "processando"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "tipo",
                  "arquivo"
                ],
                "properties": {
                  "tipo": {
                    "type": "string",
                    "enum": [
                      "escala",
                      "folha"
                    ]
                  },
                  "arquivo": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/importacoes/{id}": {
      "get": {
        "tags": [
          "Importações"
        ],
        "summary": "Resultado da importação",
        "description": "Mostra quantas linhas conferem e o motivo de cada recusa.",
        "operationId": "importacoes_consultar",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Importação"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "id": "imp_01JBX9Q2",
                  "status": "concluida",
                  "linhas": 44,
                  "conferem": 42,
                  "recusadas": [
                    {
                      "linha": 17,
                      "motivo": "CRM 99999 não encontrado"
                    },
                    {
                      "linha": 31,
                      "motivo": "Data 31/09/2026 inválida"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/cessoes": {
      "get": {
        "tags": [
          "Cessões e ciência"
        ],
        "summary": "Listar cessões",
        "description": "Cessões que vencem nas folhas do tomador.",
        "operationId": "cessoes_listar",
        "parameters": [
          {
            "name": "ciencia",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "pendente ou registrada"
          },
          {
            "name": "folha",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Data da folha"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "dados": [
                    {
                      "id": "HM-2026-0446",
                      "medico": {
                        "crm": "345678",
                        "uf": "SP"
                      },
                      "plantoes": [
                        "P-2135",
                        "P-2166"
                      ],
                      "valor": "2400.00",
                      "folha": "2026-11-25",
                      "ciencia": null,
                      "pix_pendente": true,
                      "celcoin": {
                        "application_id": "7f3c2a91-5d0e-4b7a-a1c4-9e2b6d0f8a13",
                        "status": "PENDING_DISBURSEMENT"
                      }
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/cessoes/ciencia": {
      "post": {
        "tags": [
          "Cessões e ciência"
        ],
        "summary": "Dar ciência",
        "description": "Registra a ciência do tomador. O Pix do médico sai na hora. Com a concordância automática ligada no portal, a ciência é registrada na emissão e esta chamada não é necessária.",
        "operationId": "cessoes_darCiencia",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "registradas": 2,
                  "pix_enviados": 2,
                  "desembolsos": [
                    {
                      "id": "HM-2026-0446",
                      "provedor": "celcoin",
                      "status": "ISSUED"
                    },
                    {
                      "id": "HM-2026-0447",
                      "provedor": "celcoin",
                      "status": "ISSUED"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "ids": [
                  "HM-2026-0446",
                  "HM-2026-0447"
                ],
                "por": "eduardo.pacheco@vidanova.org.br"
              }
            }
          }
        }
      }
    },
    "/cessoes/{id}/termo": {
      "get": {
        "tags": [
          "Cessões e ciência"
        ],
        "summary": "Termo de cessão (PDF)",
        "description": "Retorna o termo de cessão assinado em application/pdf.",
        "operationId": "cessoes_termo",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Cessão"
          }
        ],
        "responses": {
          "200": {
            "description": "PDF",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/folhas": {
      "get": {
        "tags": [
          "Folhas e pagamentos"
        ],
        "summary": "Agenda de folhas",
        "description": "Próximas folhas com o valor que quita CCBs e o repasse.",
        "operationId": "folhas_listar",
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "dados": [
                    {
                      "data": "2026-11-26",
                      "total": "28800.00",
                      "quita_ccbs": "12000.00",
                      "repasse": "16800.00",
                      "medicos": 11,
                      "status": "a_vencer"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/folhas/{data}": {
      "get": {
        "tags": [
          "Folhas e pagamentos"
        ],
        "summary": "Detalhe da folha",
        "description": "Lançamentos por médico, com plantões e CCBs vinculadas.",
        "operationId": "folhas_consultar",
        "parameters": [
          {
            "name": "data",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "AAAA-MM-DD"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "data": "2026-11-26",
                  "total": "28800.00",
                  "lancamentos": [
                    {
                      "medico": {
                        "crm": "123456",
                        "uf": "SP"
                      },
                      "valor": "4800.00",
                      "ccb": "HM-2026-0438",
                      "destino": "conta_credidoc"
                    }
                  ],
                  "pagamento": {
                    "provedor": "asaas",
                    "asaas_payment_id": "pay_4c1e9a07b2d35f68",
                    "invoice_url": "https://www.asaas.com/i/4c1e9a07b2d35f68",
                    "pix_copia_e_cola": "00020126...6304A1B2",
                    "boleto": "23793.38128 60000.000009 12000.000004 1 99990002880000",
                    "ted": {
                      "banco": "461",
                      "agencia": "0001",
                      "conta": "2281904-7"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/folhas/{data}/pagamento": {
      "post": {
        "tags": [
          "Folhas e pagamentos"
        ],
        "summary": "Informar pagamento",
        "description": "Avisa que a folha foi paga. A conciliação confirma o crédito e quita as CCBs.",
        "operationId": "folhas_informarPagamento",
        "parameters": [
          {
            "name": "data",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Folha"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "status": "em_conciliacao"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "valor": "28800.00",
                "meio": "pix",
                "e2e": "E6074694820261126103000000000001",
                "pago_em": "2026-11-26T10:30:00-03:00"
              }
            }
          }
        }
      }
    },
    "/pagamentos": {
      "get": {
        "tags": [
          "Folhas e pagamentos"
        ],
        "summary": "Pagamentos conciliados",
        "description": "Histórico de folhas pagas e recibos.",
        "operationId": "pagamentos_listar",
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "dados": [
                    {
                      "folha": "2026-10-26",
                      "valor": "27600.00",
                      "pago_em": "2026-10-26T09:41:00-03:00",
                      "conciliado": true,
                      "recibo": "/v1/pagamentos/pg_9F2/recibo"
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/medicos": {
      "get": {
        "tags": [
          "Médicos"
        ],
        "summary": "Listar médicos",
        "description": "Médicos com plantões no tomador.",
        "operationId": "medicos_listar",
        "parameters": [
          {
            "name": "crm",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Filtra por CRM"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "dados": [
                    {
                      "crm": "123456",
                      "uf": "SP",
                      "nome": "Ana Ribeiro",
                      "tipo": "PF",
                      "especialidade": "Clínica médica",
                      "ativo": true
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/medicos/{crm_uf}": {
      "get": {
        "tags": [
          "Médicos"
        ],
        "summary": "Consultar médico",
        "description": "Situação do médico e resumo de plantões no tomador.",
        "operationId": "medicos_consultar",
        "parameters": [
          {
            "name": "crm_uf",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "CRM e UF juntos, separados por hífen (ex.: 123456-SP)"
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "crm": "123456",
                  "uf": "SP",
                  "nome": "Ana Ribeiro",
                  "plantoes": {
                    "pendentes": 3,
                    "validados": 5,
                    "antecipados": 4
                  }
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/webhooks": {
      "get": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Listar webhooks",
        "description": "Endpoints cadastrados e eventos assinados.",
        "operationId": "webhooks_listar",
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "dados": [
                    {
                      "id": "wh_7Kp2",
                      "url": "https://erp.saolucas.org.br/webhooks/credidoc",
                      "eventos": [
                        "plantao.validado",
                        "cessao.criada",
                        "pagamento.conciliado"
                      ],
                      "ativo": true
                    }
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      },
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Criar webhook",
        "description": "O segredo de assinatura é exibido só nesta resposta.",
        "operationId": "webhooks_criar",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "id": "wh_7Kp2",
                  "segredo": "whsec_4f8b2c…",
                  "ativo": true
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "url": "https://erp.saolucas.org.br/webhooks/credidoc",
                "eventos": [
                  "plantao.validado",
                  "cessao.criada"
                ]
              }
            }
          }
        }
      }
    },
    "/webhooks/{id}/teste": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Enviar teste",
        "description": "Dispara o evento teste.ping para a URL.",
        "operationId": "webhooks_testar",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Webhook"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sucesso",
            "content": {
              "application/json": {
                "example": {
                  "entregue": true,
                  "codigo": 200,
                  "ms": 182
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    },
    "/webhooks/{id}": {
      "delete": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Remover webhook",
        "description": "Para de enviar eventos para a URL.",
        "operationId": "webhooks_remover",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Webhook"
          }
        ],
        "responses": {
          "204": {
            "description": "Sem conteúdo"
          },
          "default": {
            "$ref": "#/components/responses/Erro"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "chave": {
        "type": "http",
        "scheme": "bearer",
        "description": "Chave de API gerada no portal do hospital"
      },
      "oauth": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://auth.credidoc.com.br/oauth/token",
            "scopes": {
              "plantoes:escrita": "Enviar escala, validar e glosar",
              "plantoes:leitura": "Consultar plantões",
              "cessoes:escrita": "Dar ciência",
              "folhas:leitura": "Consultar folhas",
              "webhooks:escrita": "Gerenciar webhooks"
            }
          }
        }
      }
    },
    "schemas": {
      "Erro": {
        "type": "object",
        "properties": {
          "erro": {
            "type": "object",
            "properties": {
              "codigo": {
                "type": "string"
              },
              "mensagem": {
                "type": "string"
              },
              "campo": {
                "type": "string"
              },
              "id_requisicao": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "responses": {
      "Erro": {
        "description": "Erro",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Erro"
            }
          }
        }
      }
    }
  }
}