Documentación API-Externa SEGM

Esta documentacion tiene como objetivo explicar de forma tecnica y simple la API-Externa SEGM (Sistema Electrónico de Garantía Mobiliaria) que es una plataforma tecnológica que permite la inscripción, consulta y gestión de garantías mobiliarias en línea. Es una herramienta que facilita el acceso al crédito a través del uso de activos mobiliarios como garantía, y que cuenta con esta API de pruebas que permite realizar peticiones y experimentar con la plataforma de manera segura y controlada.

Proceso de Autenticación para la API del SEGM

Solicitar Usuario

Para poder acceder a la API de prueba del SEGM, es necesario solicitar un usuario llenando el formulario
disponible en el siguiente enlace: https://forms.office.com/r/bJPL4ksweb

Después de completar el formulario, nuestro equipo técnico del MICM evaluará su solicitud y le enviará sus credenciales por correo electrónico a la dirección proporcionada.

POSTAcceso

https://apibanks.segm.gob.do/api/Account/DoLogIn

Para acceder al SEGM, los usuarios deben realizar el proceso de inicio de sesión proporcionando su usuario y contraseña. Si las credenciales son válidas, el usuario podrá acceder al SEGM y realizar las tareas permitidas según su nivel de acceso. En caso de que las credenciales sean incorrectas, se mostrará un mensaje de error.

Es necesario utilizar las credenciales proporcionadas para acceder como usuario API. El token de acceso tiene un tiempo de vigencia de 4 horas.

Despues de tener las credenciales ingrese las mismas en el "Body" como un Json de siguiente forma:

Para el correcto uso de la Api debe copiar el Token (JwToken) y en cada metodo proporcionarlo como se indica a continuacion:

Bodyraw (json)

json

{
  "email": "string",
  "password": "string"
}

Example Request

curl

curl --location 'localhost:28029/api/Account/DoLogIn' \
--data-raw '{
  "email": "herelib932@lubde.com",
  "password": "Master@1980"
}'

200 OK

Example Response

json

{
  "succeeded": true,
  "message": "Authenticate herelib932@lubde.com",
  "errors": null,
  "data": {
    "jwToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJoZXJlbGliOTMyQGx1YmRlLmNvbSIsImp0aSI6IjVhOGNmNWY4LTYxYzgtNDE4OS1hYzc2LTg5ZDVkYzk5MGEzOSIsIkVtYWlsIjoiaGVyZWxpYjkzMkBsdWJkZS5jb20iLCJ1aWQiOiIxMTQ2IiwiaXAiOiIxOTIuMTY4LjAuMjA3IiwibmFtZSI6IkFOQSBTSUxWSUEiLCJJbnN0aXR1Y2lvbklkIjoiMTA0MyIsIklkU3VjdXJzYWwiOiIxMTUzIiwiSWRVc3VhcmlvIjoiMTE0NiIsIk9yZ2FuaXphY2lvbiI6IlRIRSA1NyBUUkFERSBHUk9VUCBTUkwiLCJOb21icmVSb2wiOiJBdmFuemFkbyIsInJvbGVzIjoiU3ViVXN1YXJpb3MiLCJleHAiOjE2NzE2ODMwNTAsImlzcyI6InNkZnNkZjQzdHlnaDZldDUxZGdkZmdkZmdzZSMkIyRlcklzdWVyIiwiYXVkIjoic2Rmc2doZ2gxZzIwZXQ1MWRnZGZnZGZnc2VkZmRmZGYifQ.cCb9q9xQJvty39sLgSmVVCO_J1U-aybnoeid0YlxTCM",
    "expiration": "2022-12-22T00:24:10.3320706-04:00"
  }
}

Content-Length

780

Content-Type

application/json; charset=utf-8

Server

Microsoft-IIS/10.0

X-Powered-By

ASP.NET

Date

Thu, 22 Dec 2022 00:24:10 GMT

Consultas a la API

GETPetición GET - Búsqueda Externa por Cédula y RNC

https://apibanks.segm.gob.do/api/Operaciones/GetByRNCOCedula/40212916007/ConsultaGratuita

Este endpoint nos permite obtener un resumen de las interacciones que una persona o empresa ha tenido con
el sistema SEGM.

Es importante destacar que esta búsqueda es gratuita.

AUTHORIZATIONBearer Token

Token

<token>

HEADERS

GetByRNCOCedula

40212916007

Example Request

curl

curl --location 'https://apibanks.segm.gob.do/api/Operaciones/GetByRNCOCedula/40212916007/consulta' \
--header 'GetByRNCOCedula;' \
--header '40212916007;'

200 OK

Example Response

json

[
  {
    "nombreDeudor": "N/A",
    "deuAcre": null,
    "rnC_cedula": "40212916007",
    "cantidadDeudor": 0,
    "cantidadBienes": 0,
    "bienSerial": null
  }
]

Content-Length

122

Content-Type

application/json; charset=utf-8

Server

Microsoft-IIS/10.0

X-Powered-By

ASP.NET

Date

Mon, 20 Mar 2023 15:32:32 GMT