A API de Protocolo Personalizado é usada para gerenciar APIs com protocolos personalizados.Com este recurso, você pode criar e manter a documentação de API para diferentes tipos de protocolos (como Thrift, UDP, Kafka, RabbitMQ, RocketMQ etc.) de forma unificada, tudo gerenciado centralmente no Apidog.Assim como a documentação de API HTTP, a documentação de API de protocolo personalizado também oferece suporte a uma árvore de pastas, opções de pesquisa e filtro, gerenciamento em massa e compartilhamento online — facilitando a colaboração entre equipes e o compartilhamento externo.
Acima da árvore de pastas, passe o cursor sobre o ícone +, selecione New Other Protocol APIs e clique em Other Custom Protocol API.
2
Selecione um tipo de protocolo (as opções incluem Thrift, Kafka etc., ou clique em Manage Protocol para adicionar um protocolo personalizado).
Há templates padrão disponíveis para cada protocolo.
3
Preencha os seguintes detalhes:
URI: O ID exclusivo do endpoint, usado para diferenciá-lo dos demais (semelhante a um caminho de URL para endpoints HTTP).
Endpoint Name: O nome do endpoint.
Basic Information: Status, responsáveis pela manutenção, tags e outros detalhes.
Documentation Details: Permite editar descrições, instruções de uso, exemplos e muito mais de forma flexível.
4
Depois de salvar, você verá a documentação do endpoint criada para o protocolo selecionado.
Compartilhamento da Documentação de API de Protocolo Personalizado#
A documentação de API de protocolo personalizado também oferece suporte ao compartilhamento online, facilitando a colaboração e a apresentação externa.Você pode copiar um link de colaboração para compartilhar dentro do projeto.
Você também pode acessar Publish Docs > Quick Share, selecionar quais endpoints incluir e escolher se deseja compartilhar a documentação de API de protocolo personalizado.