carto
/
grpc


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.17"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>GRPC PHP: HTTP to gRPC Status Code Mapping</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">GRPC PHP
   &#160;<span id="projectnumber">1.36.1</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.17 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

</div><!-- top -->
<div class="PageDoc"><div class="header">
  <div class="headertitle">
<div class="title">HTTP to gRPC Status Code Mapping </div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Since intermediaries are a common part of HTTP infrastructure some responses to gRPC requests may be received that do not include the grpc-status header. In some cases mapping error codes from an intermediary allows the gRPC client to behave more appropriately to the error situation without overloading the semantics of either error code.</p>
<p>This table is to be used <em>only</em> for clients that received a response that did not include grpc-status. If grpc-status was provided, it <em>must</em> be used. Servers <em>must not</em> use this table to determine an HTTP status code to use; the mappings are neither symmetric nor 1-to-1.</p>
<table class="markdownTable">
<tr class="markdownTableHead">
<th class="markdownTableHeadNone">HTTP Status Code </th><th class="markdownTableHeadNone">gRPC Status Code  </th></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">400 Bad Request </td><td class="markdownTableBodyNone">INTERNAL  </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">401 Unauthorized </td><td class="markdownTableBodyNone">UNAUTHENTICATED  </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">403 Forbidden </td><td class="markdownTableBodyNone">PERMISSION_DENIED  </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">404 Not Found </td><td class="markdownTableBodyNone">UNIMPLEMENTED  </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">429 Too Many Requests </td><td class="markdownTableBodyNone">UNAVAILABLE  </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">502 Bad Gateway </td><td class="markdownTableBodyNone">UNAVAILABLE  </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone">503 Service Unavailable </td><td class="markdownTableBodyNone">UNAVAILABLE  </td></tr>
<tr class="markdownTableRowEven">
<td class="markdownTableBodyNone">504 Gateway Timeout </td><td class="markdownTableBodyNone">UNAVAILABLE  </td></tr>
<tr class="markdownTableRowOdd">
<td class="markdownTableBodyNone"><em>All other codes</em> </td><td class="markdownTableBodyNone">UNKNOWN  </td></tr>
</table>
<p>Technically, 1xx should have the entire header skipped and a subsequent header be read. See RFC 7540 §8.1.</p>
<p>200 is UNKNOWN because there should be a grpc-status in case of truly OK response. </p>
</div></div><!-- contents -->
</div><!-- PageDoc -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Wed Mar 3 2021 19:20:17 for GRPC PHP by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.17
</small></address>
</body>
</html>