|
- Error de seguridad en una transacción segura
- Recuperación
- Acceso a una URL protegida por contraseña
- Uso de un proxy
- Cabeceras de autenticación
- Límites
- Característica de aplicación requerida
HTTPCreateForm("FORM")
HTTPAddParameter("FORM", "Price", "3400")
...
HTTPSendForm("FORM", "www.mysite.com")
// Example for sending a file
lIdForm = "TEST"
HTTPCreateForm(lIdForm)
HTTPAddFile(lIdForm, "file", "C:\temp\Certificate.pdf")
IF NOT HTTPSendForm(lIdForm, "http://test.myserver.net", httpPost, "AGENT") THEN
...
END
Sintaxis
Full syntax Ocultar los detalles
<Result> = HTTPSendForm(<Form Name> , <URL to contact> [, <HTTP Method> [, <User agent> [, <Additional HTTP Header> [, <Type of Form> [, <User name> [, <Password>]]]]]])
<Result>: Boolean - True si se envió el formulario HTTP,
- False si se ha producido un error. Para conocer los detalles del error, utilice ErrorInfo el comando Mensaje de error constante.
<Form Name>: Character string (with quotes) Nombre del formulario HTTP a enviar. <URL to contact>: Character string (with quotes) Dirección del servidor a contactar (dirección URL).
Este parámetro puede contener el número de puerto para conectarse al servidor. El valor por defecto es 80 (corresponde a un servidor de páginas Web). Para especificar un número de puerto, utilice el siguiente formato: "<URL del servidor>:<N° del puerto>".
Por ejemplo:: http://www.pcsoft.fr:80.Nota: Para realizar una transacción segura, la URL debe comenzar por "https://". <HTTP Method>: Optional Integer constant Método HTTP utilizado: | |  Versiones 19 y posterioreshttpCopia Nueva funcionalidad versión 19httpCopia | Método COPYVersiones 22 y posteriores Nueva funcionalidad versión 22 | | httpBorrar | Método DELETE | | httpGet | Método GET | Versiones 19 y posterioreshttpHead Nueva funcionalidad versión 19httpHead httpHead | Método HEAD
Versiones 22 y posteriores Nueva funcionalidad versión 22 | Versiones 19 y posterioreshttpPatch Nueva funcionalidad versión 19httpPatch httpPatch | Método PATCH
Versiones 22 y posteriores Nueva funcionalidad versión 22 | httpPost
(Valor predeterminado) | Método POST | | httpPut | Método PUT |
<User agent>: Optional character string (with quotes) Identifica al cliente. Por defecto, se devuelve el valor "PC SOFT Framework".
El contenido de la respuesta puede depender del agente de usuario. En este caso, consulte la documentación del agente de usuarios para obtener más detalles..
<Additional HTTP Header>: Optional character string (with quotes) - Cabecera HTTP adicional que se añadirá al mensaje HTTP. Atención: esta cadena debe terminar con un carácter CR (Carriage Return).
- Cadena vacía ("") si se debe agregar ninguna solicitud HTTP.
<Type of Form>: Optional character string (with quotes) or optional constant Tipo de formulario que se enviará al servidor. Este parámetro corresponde a "Content-Type".
Por defecto, el tipo de mensaje corresponde a: "application/x-www-form-urlencoded".
Versiones 22 y posterioresEste parámetro puede corresponder a una de las siguientes constantes: | | | typeMimeMultiPartForm | La clase de mensaje corresponde a: "multipart/form-data" (utilizado principalmente para transferir archivos). | typeMimeSimpleForm
(Valor predeterminado) | La clase de mensaje corresponde a: "application/x-www-form-urlencoded". |
Nueva funcionalidad versión 22Este parámetro puede corresponder a una de las siguientes constantes: | | | typeMimeMultiPartForm | La clase de mensaje corresponde a: "multipart/form-data" (utilizado principalmente para transferir archivos). | typeMimeSimpleForm
(Valor predeterminado) | La clase de mensaje corresponde a: "application/x-www-form-urlencoded". |
Este parámetro puede corresponder a una de las siguientes constantes:
| | | typeMimeMultiPartForm | La clase de mensaje corresponde a: "multipart/form-data" (utilizado principalmente para transferir archivos). | typeMimeSimpleForm
(Valor predeterminado) | La clase de mensaje corresponde a: "application/x-www-form-urlencoded". |
<User name>: Optional character string (with quotes) Nombre utilizado para acceder a una página con una URL protegida (cadena vacía por defecto). Este nombre se utiliza para identificar al usuario. <Password>: Optional character string (with quotes) Contraseña asociada al nombre de usuario (cadena vacía por defecto). Se utiliza para acceder a una página con una URL protegida. Atención: La contraseña no está encriptada cuando se envía por Internet. Versiones 20 y posteriores Nueva funcionalidad versión 20 Observaciones Error de seguridad en una transacción segura Durante una transacción segura, el envío del formulario puede fallar debido a errores de seguridad: - certificado no válido o certificado procedente de una empresa desconocida.
- el nombre del sitio especificado en el certificado no corresponde a un servidor.
- fecha del certificado inválido o caducado.
- redirección a un servidor no seguro.
Si se produce uno de estos errores, puede volver a ejecutar la orden ignorando los errores.. Se pueden utilizar dos métodos según la sintaxis: - Sintaxis 1: utilizando el HTTP: IgnorarError (véase el párrafo siguiente).
Versiones 20 y posteriores    Sintaxis 2: utilizando el ..IgnorarError propiedad de httpRequest variable. Nueva funcionalidad versión 20 Sintaxis 2: utilizando el ..IgnorarError propiedad de httpRequest variable. Sintaxis 2: utilizando el ..IgnorarError propiedad de httpRequest variable.
Si se utiliza la sintaxis completa (sintaxis 1)todo lo que tiene que hacer es utilizar la función HTTP: IgnorarError variable: | | | Error devuelto por ErrorInfo
(con la constante errCode) | Valor de HTTP.IgnoreError
(estos valores se pueden combinar) | Descripción |
|---|
httpErrorInvalidCertificate
Certificado no válido o certificado procedente de una empresa desconocida | httpIgnoreInvalidCertificate | El certificado se ignora. | httpErrorInvalidCertificateName
El nombre del sitio especificado en el certificado no corresponde a un servidor | httpIgnoreInvalidCertificateName | Se ignora el nombre del sitio especificado en el certificado. | httpErrorExpiredCertificate
Fecha del certificado inválido o caducado | httpIgnoreExpiredCertificate | Se ignora la fecha del certificado | httpErrorRedirectToHTTP
Redirección a un servidor no seguro | httpIgnoreRedirectToHTTP | La redirección a un servidor no seguro está permitida. | httpIgnoreRedirectToHTTTPS
Redirección a un servidor seguro | httpIgnoreRedirectToHTTTPS | La redirección a un servidor seguro está permitida. |
Por ejemplo:
// Send a form on a secure server
ResStart = HTTPSendForm("FORM", "https://www.MyServer.com")
// If an error occurs
IF ResStart = False THEN
// According to the type of error
SWITCH ErrorInfo(errCode)
// Invalid certificate or coming from an unknown company
CASE httpErrorInvalidCertificate:
// Ignore the certificate?
IF YesNo("Caution, a security alert was detected!", ...
"The certificate is invalid.", ...
"Do you want to ignore this certificate?") = Yes THEN
HTTP.IgnoreError = httpIgnoreInvalidCertificate
// Send the form again while ignoring this error
HTTPSendForm("FORM", "https://www.MyServer.com")
END
// Invalid or expired certificate date
CASE httpErrorExpiredCertificate:
// Ignore the certificate date?
IF YesNo("Caution, a security alert was detected!", ...
"The certificate date is invalid or expired.", ...
"Do you want to ignore this date?") = Yes THEN
HTTP.IgnoreError = httpIgnoreExpiredCertificate
// Send the form again while ignoring this error
HTTPSendForm("FORM", "https://www.MyServer.com")
END
END
END
Recuperación HTTPGetResult se utiliza para recuperar el resultado del último formulario HTTP enviado. Acceso a una URL protegida por contraseña Para acceder a una URL protegida por contraseña, puede hacerlo: - utilice los parámetros <Nombre de usuario> y <Contraseña> que se encuentran en HTTPSendForm.
- especifique el nombre de usuario y la contraseña en el parámetro <URL to Contact>..
Por ejemplo:
<Result> = HTTPSendForm("http://<user>:<password>@<URL to contact>")
Uso de un proxy Para acceder a la URL especificada en la función HTTPSendForm mediante un proxy, utilice la función Proxy. Cabeceras de autenticación Las cabeceras de autenticación se generan automáticamente en los siguientes casos: - Si HTTPSendForm está usando la sintaxis con login y contraseña.
- Si la URL del servidor está protegida con contraseña
- Si Proxy se utiliza.
Versiones 21 y posteriores Nueva funcionalidad versión 21 Componente : wd250com.dll
Esta página también está disponible para…
|
|
|
| |
| Haga clic en [Agregar] para publicar un comentario |
|
| |
|
| |
| |
| |
| |
| |
| |
| | |
| |