Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Web Services para Consultar Encuestas ya realizadas a los Clientes.
DESCRIPCIÓN.
Este Web Service, permite consultar las Encuestas Realizadas a los Clientes registrados en la Aplicación SIFCO WEB, obteniendo una descripción detallada de la misma tanto a nivel de preguntas, como de respuestas obtenidas de los clientes, y indicadores de valor obtenidos en la encuesta.
Swagger open api macro |
---|
swagger: '2.0' info: title: "SIFCO_REST_API" version: "1.0" termsOfService: "https://sifco.org/sobre-nosotros/" contact: email: "soporte@sifco.org" license: name: "Apache 2.0" url: "http://www.apache.org/licenses/LICENSE-2.0.html" host: "<SERVER>" schemes: - https - http basePath: /<APPDIR>/rest tags: - name: "PPI_EncuestaRealizadas" externalDocs: description: "Manual SIFCO" url: "https://sifco.atlassian.net/wiki/x/EQDc" produces: - application/json paths: /PPI_EncuestaRealizadas/{PPI_EncuestaCorrelativo}: get: tags: - PPI_EncuestaRealizadas operationId: "GetPPI_EncuestaRealizadas" summary: "Consultar las Encuestas Realizadas con su Correlativo correspondiente a un Cliente en el Sistema" parameters: - in: header name: Content-Type type: "string" required: true default: application/json - in: header name: Authorization type: "string" required: true default: OAuth <Access Token> - in: header name: GENEXUS-AGENT type: "string" required: true default: SmartDevice Application - name: "PPI_EncuestaCorrelativo" in: "path" description: "Correlativo" required: true type: "integer" format: "int64" responses: 200: description: "Successful operation" schema: $ref: "#/definitions/PPI_EncuestaRealizadas" 400: description: "Bad request" schema: $ref: "#/definitions/GxJsonError" 401: description: "Not Authenticated" schema: $ref: "#/definitions/GxJsonError" 404: description: "Data with the specified key could not be found" schema: $ref: "#/definitions/GxJsonError" 500: description: "Internal server error" schema: $ref: "#/definitions/GxJsonError" postsecurity: - OAuth2: [] tagsApiKeyAuth1: [] securityDefinitions: OAuth2: - PPI_EncuestaRealizadastype: oauth2 operationIdflow: "InsertPPI_EncuestaRealizadas"password tokenUrl: summary: "Insertar las Encuestas Realizadas con su Correlativo correspondiente a un Cliente en el Sistema"https://test.sifco.org/DemoCoopGT/oauth/access_token scopes: Execute: Permite el método tipo GET parametersInsert: Permite el método tipo POST - inUpdate: headerPermite el método tipo PUT nameDelete: Content-TypePermite el método tipo DELETE typeFullControl: "string"Permite el manejo de los Cuatro Métodos GET, POST, PUT,DELETE, sobre required:el trueWeb Service ApiKeyAuth1: type: apiKey default: application/json in: header - inname: headergranttype definitions: PPI_EncuestaRealizadas: nameproperties: Authorization PPI_EncuestaCorrelativo: type: "string" description: Correlativo required: true type: "integer" defaultformat: OAuth <Access Token>"int64" - inPPI_EncuestaID: header namedescription: GENEXUS-AGENTEncuesta Realizada type: "stringinteger" requiredformat: true"int32" defaultPPI_EncuestaEstado: SmartDevice Application - namedescription: "PPI_EncuestaCorrelativo"Estado intype: "pathboolean" descriptionPPI_Cliente: "Correlativo" requireddescription: trueCliente type: "integer" format: "int64" - name: "PPI_EncuestaRealizadas"ClienteActivo: description: Cliente in: "body" Activo al Momento de la Encuesta description: "SDT of type: "boolean" PPI_EncuestaRealizadas"ClienteCiclo: requireddescription: falseCiclo al Momento de la Encuesta schema: type: "integer" $refformat: "#/definitions/PPI_EncuestaRealizadasint32" responsesPPI_EncuestaFechaRealizada: 200description: Fecha descriptiontype: "Successful operationstring" format: "date" schema: PPI_EncuestaEncuestador: $ref: "#/definitions/PPI_EncuestaRealizadas" description: Encuestador 201type: "string" PPI_EncuestaOperador: description: "Created" description: Operador schema: type: "string" $ref: "#/definitions/PPI_EncuestaRealizadas"EncuestaFechaOperacion: 400description: Fecha Operación descriptiontype: "string"Bad request" format: "date-time" schema: PPI_EncuestaUltimoOperador: $ref: "#/definitions/GxJsonError" description: Ultima persona en Operar 401: type: "string" description: "Not Authenticated" PPI_EncuestaFechaSupervision: schemadescription: Fecha de Supervisión $reftype: "#/definitions/GxJsonErrorstring" 404format: "date-time" descriptionPPI_EncuestaRealizadaScore: "Data with the specified key could not be found"description: Score schema:type: "integer" $refformat: "#/definitions/GxJsonErrorint32" 500PPI_EncuestaRealizadaEstado: description: "InternalEstado serverde error"la Encuesta schema:type: "boolean" PPI_EncuestaSupervisor: $ref: "#/definitions/GxJsonError" description: Supervisor put: tagstype: "string" - PPI_EncuestaRealizadasgx_md5_hash: operationId: "UpdatePPI_EncuestaRealizadas" summary: "Actualizar las Encuestas Realizadas con su Correlativo correspondiente a un Cliente en el Sistema" parameters: description: gx_md5_hash is an identifier for a specific version of a resource, it is used for optimistic concurrency check. It is required for update and delete operations and ignored on insert. - intype: header"string" EncuestaRealizadaPreguntas: name: Content-Type $ref: "#/definitions/PPI_EncuestaRealizadas.EncuestaRealizadaPreguntas" type: "string" EncuestaIndicadores: required: true$ref: "#/definitions/PPI_EncuestaRealizadas.EncuestaIndicadores" required: default: application/json - PPI_EncuestaCorrelativo PPI_EncuestaRealizadas.EncuestaRealizadaPreguntas: - inproperties: header PPI_EncuestaPreguntaID: name: Authorization description: Pregunta type: "stringinteger" format: "int32" required: true PPI_EncuestaPreguntaTexto: defaultdescription: OAuthTexto <Accessde Token>la Pregunta - in: header type: "string" PPI_EncuestaPreguntaObligatoria: namedescription: GENEXUS-AGENT Es una pregunta obligatoria type: "stringboolean" requiredPPI_EncuestaPreguntaTipo: true description: Tipo de default:Pregunta SmartDevice Application - name: "PPI_EncuestaCorrelativotype: "integer" informat: "pathint32" PPI_EncuestaRealizadaRespuesta: description: "Correlativo" description: Respuesta required: true type: "string" type: "integer"PPI_EncuestaRealizadaRespTxt: formatdescription: "int64"Respuesta Texto - nametype: "PPI_EncuestaRealizadasstring" PPI_EncuestaRealizadaRespFecha: in: "body" description: Respuesta Fecha description type: "SDTstring" of PPI_EncuestaRealizadas" format: "date" required: true PPI_EncuestaRealizadaRespMonto: schema: description: Respuesta Monto $reftype: "#/definitions/PPI_EncuestaRealizadasnumber" format: "double" responses PPI_EncuestaRealizadaRespCantidad: 200description: Respuesta Cantidad descriptiontype: "Successful operationinteger" schemaformat: "int64" $ref: "#/definitions/PPI_EncuestaRealizadas" 400: PPI_EncuestaRealizadaPreguntaScore: description: "BadPunteo request"según el Score schematype: "integer" $refformat: "#/definitions/GxJsonErrorint32" 401PPI_EncuestaRespuestaScoreOriginal: description: "NotPunteo Authenticated"para la pregunta schematype: "integer" format: $ref: "#/definitions/GxJsonError"int32" required: 404: - PPI_EncuestaPreguntaID descriptionx-gx-level: "PPI_EncuestaRealizadas"Not found" PPI_EncuestaRealizadas.EncuestaIndicadores: properties: schema: PPI_IndicadorID: $refdescription: "#/definitions/GxJsonError" Indicador de Pobreza a Medir ID 409: type: "integer" description: "PPI_EncuestaRealizadas was changed format: "int32" 500PPI_Indicador: description: "InternalIndicador serverde error"Pobreza a Medir schematype: "string" PPI_EncuestaRealizadaIndicadorValor: $ref: "#/definitions/GxJsonError" deletedescription: Valor tags: type: "number" - PPI_EncuestaRealizadas operationIdformat: "DeletePPI_EncuestaRealizadasdouble" summaryrequired: "Eliminar las Encuestas Realizadas con su Correlativo- correspondientePPI_IndicadorID a un Cliente en el Sistema" x-gx-level: "PPI_EncuestaRealizadas" GxJsonError: parametersproperties: error: - in: header $ref: "#/definitions/GxJsonError.error" nameGxJsonError.error: Content-Type properties: typecode: "string" requireddescription: trueCódigo de Error defaulttype: application/json"string" - inmessage: header namedescription: AuthorizationMensaje de Error type: "string" required: true default: OAuth <Access Token> - in: header name: GENEXUS-AGENT type: "string" required: true default: SmartDevice Application - name: "PPI_EncuestaCorrelativo" in: "path" description: "Correlativo" required: true type: "integer" format: "int64" responses: 200: description: "Successful operation" schema: $ref: "#/definitions/PPI_EncuestaRealizadas" 204: description: "Successful operation" schema: $ref: "#/definitions/PPI_EncuestaRealizadas" 400: description: "Bad request" schema: $ref: "#/definitions/GxJsonError" 401: description: "Not Authenticated" schema: $ref: "#/definitions/GxJsonError" 404: description: "Not found" schema: $ref: "#/definitions/GxJsonError" 500: description: "Internal server error" schema: $ref: "#/definitions/GxJsonError" security: - OAuth2: [] ApiKeyAuth1: [] securityDefinitions: OAuth2: type: oauth2 flow: password tokenUrl: https://test.sifco.org/DemoCoopGT/oauth/access_token scopes: Execute: Permite el método tipo GET Insert: Permite el método tipo POST Update: Permite el método tipo PUT Delete: Permite el método tipo DELETE FullControl: Permite el manejo de los Cuatro Métodos GET, POST, PUT,DELETE, sobre el Web Service ApiKeyAuth1: type: apiKey in: header name: granttype definitions: PPI_EncuestaRealizadas: properties: PPI_EncuestaCorrelativo: description: Correlativo type: "integer" format: "int64" PPI_EncuestaID: description: Encuesta Realizada type: "integer" format: "int32" PPI_EncuestaEstado: description: Estado type: "boolean" PPI_Cliente: description: Cliente type: "integer" format: "int64" PPI_ClienteActivo: description: Cliente Activo al Momento de la Encuesta type: "boolean" PPI_ClienteCiclo: description: Ciclo al Momento de la Encuesta type: "integer" format: "int32" PPI_EncuestaFechaRealizada: description: Fecha type: "string" format: "date" PPI_EncuestaEncuestador: description: Encuestador type: "string" PPI_EncuestaOperador: description: Operador type: "string" PPI_EncuestaFechaOperacion: description: Fecha Operación type: "string" format: "date-time" PPI_EncuestaUltimoOperador: description: Ultima persona en Operar type: "string" PPI_EncuestaFechaSupervision: description: Fecha de Supervisión type: "string" format: "date-time" PPI_EncuestaRealizadaScore: description: Score type: "integer" format: "int32" PPI_EncuestaRealizadaEstado: description: Estado de la Encuesta type: "boolean" PPI_EncuestaSupervisor: description: Supervisor type: "string" gx_md5_hash: description: gx_md5_hash is an identifier for a specific version of a resource, it is used for optimistic concurrency check. It is required for update and delete operations and ignored on insert. type: "string" EncuestaRealizadaPreguntas: $ref: "#/definitions/PPI_EncuestaRealizadas.EncuestaRealizadaPreguntas" EncuestaIndicadores: $ref: "#/definitions/PPI_EncuestaRealizadas.EncuestaIndicadores" required: - PPI_EncuestaCorrelativo PPI_EncuestaRealizadas.EncuestaRealizadaPreguntas: properties: PPI_EncuestaPreguntaID: description: Pregunta type: "integer" format: "int32" PPI_EncuestaPreguntaTexto: description: Texto de la Pregunta type: "string" PPI_EncuestaPreguntaObligatoria: description: Es una pregunta obligatoria type: "boolean" PPI_EncuestaPreguntaTipo: description: Tipo de Pregunta type: "integer" format: "int32" PPI_EncuestaRealizadaRespuesta: description: Respuesta type: "string" PPI_EncuestaRealizadaRespTxt: description: Respuesta Texto type: "string" PPI_EncuestaRealizadaRespFecha: description: Respuesta Fecha type: "string" format: "date" PPI_EncuestaRealizadaRespMonto: description: Respuesta Monto type: "number" format: "double" PPI_EncuestaRealizadaRespCantidad: description: Respuesta Cantidad type: "integer" format: "int64" PPI_EncuestaRealizadaPreguntaScore: description: Punteo según el Score type: "integer" format: "int32" PPI_EncuestaRespuestaScoreOriginal: description: Punteo para la pregunta type: "integer" format: "int32" required: - PPI_EncuestaPreguntaID x-gx-level: "PPI_EncuestaRealizadas" PPI_EncuestaRealizadas.EncuestaIndicadores: properties: PPI_IndicadorID: description: Indicador de Pobreza a Medir ID type: "integer" format: "int32" PPI_Indicador: description: Indicador de Pobreza a Medir type: "string" PPI_EncuestaRealizadaIndicadorValor: description: Valor type: "number" format: "double" required: - PPI_IndicadorID x-gx-level: "PPI_EncuestaRealizadas" GxJsonError: properties: error: $ref: "#/definitions/GxJsonError.error" GxJsonError.error: properties: code: description: Código de Error type: "string" message: description: Mensaje de Error type: "string" x-gx-level: "GxJsonError"x-gx-level: "GxJsonError" |
EJEMPLOS DE REQUEST Y RESPONSE, PARA LOS SERVICIOS RESTful BAJO PROTOCOLO HTTP.
A continuación se muestra una tabla con un ejemplo de una Solicitud y un Respuesta para este Web Service.
METODO GET
Este método para este Web Service en especifico permite consultar las encuestas realizadas a los Clientes registrados en la Aplicación SIFCO WEB.
El siguiente ejemplo permite consultar una encuesta realizada a un Cliente registrado en la en la Aplicación SIFCO WEB.
Tipo de Mensaje HTTP | Ejemplo | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
REQUEST | URL:
HEADERS
| ||||||||||
200 (Successful operation) Operación Exitosa |
| ||||||||||
400 (Bad Request). Solicitud Errada |
| ||||||||||
401 (This service needs an Authorization Header) (No Autenticado, asociado normalmente a que no se respetaron las cabeceras obligatorias para el consumo de este Web Service, para mayores detalles consultar (Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services) ). |
| ||||||||||
404 (Not Found). | Respuesta Vacía (Web Service, no encontrado) | ||||||||||
500 (Internal Server Error) (Error Interno del Servidor de las API’s REST). |
|
Info |
---|
INFORMACIÓN Para identificar el MENSAJE DE ERROR remitirse a la pagina de (Listado de Mensajes), donde se describe el listado de mensajes que arroja las API’s REST de la Aplicación SIFCO WEB, con su respectiva Descripción. |
Note |
---|
NO DEBE OLVIDAR NO olvide tomar en cuenta para el uso de este Web Service, el Flujo de Trabajo descrito en Web Services de Clientes, dado a que en caso de no seguirlo al pie de la letra puede generar errores inesperados en la ejecución. |
Note |
---|
RESPETE LOS ENCABEZADOS OBLIGATORIOS para que pueda consumir el WEB SERVICE respectivo. |
Code Block | ||
---|---|---|
| ||
Content-Type: application/json Authorization: OAuth f2a9ec34-cf83-46f5-8862-f78ac03670d1!171380a787a9152688ab61a94d66e0eb77... GENEXUS-AGENT: SmartDevice Application |
Warning |
---|
EN CASO DE ERROR HTTP 401 (Not Authenticated) Por favor validar que esta colocando los Encabezados Adecuadamente, y de persistir el problema dirigirse a la Pagina (Configuración de Seguridad para Obtener Token de Acceso y Consumir de los Web Services), para generar nuevamente su Token de Acceso, y/o verificar problemas con su acceso al API REST. |
| ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Artículos Relacionados
| ||||||||||||
Artículos Actualizados Recientemente
| ||||||||||||
|