ResponseCard

Domain · API Doc

Tek bir API yanıtını katlanabilir kart içinde gösterir. Durum kodu rozeti, açıklama ve şema içerir.

200 OK response

Preview

200 Token issued application/json

Schema rendered here

Code

<%- include('modules/domain/api-doc/ResponseCard', {
  response: {
    responseId: 'r-200',
    statusCode: '200',
    description: 'Token issued',
    content: { 'application/json': { schema: { type: 'object' } } }
  }
}) %>

Source modules/domain/api-doc/ResponseCard.ejs

<%
  var _response    = locals.response    || {};
  var _defaultOpen = locals.defaultOpen !== false;
  var code = String(_response.statusCode || '');
  var n    = parseInt(code, 10);

  var badgeStyle;
  if      (n >= 200 && n < 300) badgeStyle = 'bg-success-subtle text-success-fg';
  else if (n >= 300 && n < 400) badgeStyle = 'bg-info-subtle text-info-fg';
  else if (n >= 400 && n < 500) badgeStyle = 'bg-warning-subtle text-warning-fg';
  else if (n >= 500)            badgeStyle = 'bg-error-subtle text-error-fg';
  else                          badgeStyle = 'bg-surface-overlay text-text-secondary';

  var contentEntries = _response.content ? Object.entries(_response.content) : [];
  var headers        = _response.headers  ? Object.entries(_response.headers)  : [];
%>
>
  
    <%= code %>
    <%= _response.description || '' %>
    <% if (contentEntries.length > 0) { %>
      <%= contentEntries[0][0] %>
    <% } %>
    
  

  
    <% if (headers.length > 0) { %>
    
      Response Headers
      
        <% headers.forEach(function(entry) {
          var hKey = entry[0];
          var hdr  = entry[1];
        %>
          
            <%= hKey %>
            <% if (hdr.schema && hdr.schema.type) { %><%= hdr.schema.type %><% } %>
            <% if (hdr.description) { %><%= hdr.description %><% } %>
          
        <% }); %>
      
    
    <% } %>

    <% if (contentEntries.length > 0) { %>
      
        <% contentEntries.forEach(function(entry) {
          var mime   = entry[0];
          var obj    = entry[1];
        %>
          
            <%= mime %>
            <% if (obj.schema) { %>
              <%- include('./SchemaViewer', { schema: obj.schema }) %>
            <% } %>
          
        <% }); %>
      
    <% } else { %>
      No response body.
    <% } %>