HTTP service "http:C"
| Command Header
|
Available since system-version
|
Description
|
| 0x00010044
|
|
Initialize
|
| 0x00020082
|
|
CreateContext
|
| 0x00030040
|
|
CloseContext
|
| 0x00040040
|
|
CancelConnection
|
| 0x00050040
|
|
GetRequestState
|
| 0x00060040
|
|
GetDownloadSizeState
|
| 0x00070040
|
|
GetRequestError
|
| 0x00080042
|
|
InitializeConnectionSession
|
| 0x00090040
|
|
BeginRequest
|
| 0x000A0040
|
|
BeginRequestAsync
|
| 0x000B0082
|
|
ReceiveData
|
| 0x000C0102
|
|
ReceiveDataTimeout
|
| 0x000D0146
|
|
SetProxy
|
| 0x000E0040
|
|
SetProxyDefault
|
| 0x000F00C4
|
|
SetBasicAuthorization
|
| 0x00100080
|
|
SetSocketBufferSize
|
| 0x001100C4
|
|
AddRequestHeader
|
| 0x001200C4
|
|
AddPostDataAscii
|
| 0x001300C4
|
|
AddPostDataBinary
|
| 0x00140082
|
|
AddPostDataRaw
|
| 0x00150080
|
|
SetPostDataType(u8 enum)
|
| 0x001600C4
|
|
SendPostDataAscii
|
| 0x00170144
|
|
SendPostDataAsciiTimeout
|
| 0x001800C4
|
|
SendPostDataBinary
|
| 0x00190144
|
|
SendPostDataBinaryTimeout
|
| 0x001A0082
|
|
SendPostDataRaw
|
| 0x001B0102
|
|
SendPOSTDataRawTimeout
|
| 0x001C0080
|
|
SetPostDataEncoding
|
| 0x001D0040
|
|
NotifyFinishSendPostData
|
| 0x001E00C4
|
|
GetResponseHeader
|
| 0x001F0144
|
|
GetResponseHeaderTimeout
|
| 0x00200082
|
|
GetResponseData
|
| 0x00210102
|
|
GetResponseDataTimeout
|
| 0x00220040
|
|
GetResponseStatusCode
|
| 0x002300C0
|
|
GetResponseStatusCodeTimeout
|
| 0x00240082
|
|
AddTrustedRootCA
|
| 0x00250080
|
|
AddDefaultCert
|
| 0x00260080
|
|
SelectRootCertChain With 2.0.0-X this just eventually returns error 0xd960a3f4.
|
| 0x002700C4
|
|
SetClientCert
|
| 0x00280080
|
|
Somehow related to SetClientCert.
|
| 0x00290080
|
|
|
| 0x002A0040
|
|
GetSSLError?
|
| 0x002B0080
|
|
|
| 0x002C0080
|
|
|
| 0x002D0000
|
|
CreateRootCertChain
|
| 0x002E0040
|
|
|
| 0x002F0082
|
|
RootCertChainAddCert
|
| 0x00300080
|
|
RootCertChainAddDefaultCert
|
| 0x00310080
|
|
|
| 0x00320084
|
|
|
| 0x00330040
|
|
|
| 0x00340040
|
|
|
| 0x00350186
|
|
SetDefaultProxy
|
| 0x00360000
|
|
ClearDNSCache
|
| 0x00370080
|
|
SetKeepAlive (bool)
|
| 0x003800C0
|
Unknown, >2.0.0-X.
|
SetPostDataTypeSize (u8 enum, u32 size) (similar to SetPostDataType)
|
| 0x00390000
|
Unknown, >2.0.0-X.
|
Finalize
|
| 0x003A....
|
Unknown, >2.0.0-X.
|
|
| 0x003B0082
|
Unknown, >2.0.0-X.
|
|
| 0x003C....
|
Unknown, >2.0.0-X.
|
|
| 0x003D....
|
Unknown, >2.0.0-X.
|
|
| 0x003E....
|
Unknown, >2.0.0-X.
|
|
| 0x003F....
|
Unknown, >2.0.0-X.
|
|
| 0x00400082
|
Unknown, >2.0.0-X.
|
|
| 0x0041....
|
Unknown, >2.0.0-X.
|
|
| 0x0042....
|
Unknown, >2.0.0-X.
|
|
TLS Root CAs
Initially a HTTP context will not trust any root-CAs at all. Which root-CAs to trust must be explicitly specified via the add-root-CA service command(s).
RootCertChains can be used to easily select a particular chain of trusted root-CAs with multiple HTTP contexts, without having to re-send each of the root-CA commands for each HTTP context. The maximum number of RootCertChains that can exist for a HTTPC service session handle, is only 1.
Error codes
| Error code
|
Description
|
| 0xd8a0a03c
|
The HTTPS server's TLS certificate is signed by an unknown/not-trusted root CA.
|
| 0xd8a0a046
|
This is returned by HTTPC:Initialize when no network connection is available(or at least when wifi is disabled via Home Menu on New3DS).
|
| 0xd8a0a066
|
This indicates that the context handle is wrong.
|