Skip to content

Latest commit

 

History

History
71 lines (55 loc) · 2.54 KB

README.MD

File metadata and controls

71 lines (55 loc) · 2.54 KB
Raw

Estafeta API

Sin relación alguna con Estafeta, es una API desarrollada con PHP que proporciona información relacionada con un envió en formato JSON. Para hacer esto hace una petición POST a la pagina de rastreo de Estafeta y parsea la pagina resultante para construir la información del paquete.

No es estable para desarrollos productivos ya que:

  • Depende de que Estafeta no cambie el DOM de la pagina que contiene la info de los envíos ya que la API parsea en duro de acuerdo a la posición (Ej. el 7 elemento de texto del DOM de la respuesta)
  • Depende de que Estafeta no implemente captcha para solicitar información del envíos
  • Depende de que Estafeta no implemente autentificación, cambie URL o bloquee peticiones externas
  • Depende que no se exceda el limite de búsquedas de la API de geolocalización de Google Maps

Actualmente proporciona la siguiente info

  • Número de guía Código de rastreo
  • Código de rastreo
  • Tipo de servicio
  • Fecha programada de entrega
  • Lugar de origen (nombre y coordenadas usando la API de geolocalización Google Maps)
  • Fecha de recolección
  • Hora de recolección
  • Lugar de destino (nombre, código postal y coordenadas usando la API de geolocalización Google Maps)
  • Estatus del envío
  • Fecha de entrega
  • Hora de entrega

TODO:

  • Generar historia del envió
  • Cache

Uso:

http://localhost/EstafetaAPI/api?numero=GUIA_O_CODIGO_DE_RASTREO

Ejemplo de error

{
  "error":2,
  "mensaje_error":"No hay informaci\u00f3n disponible"
}

Ejemplo de respuesta exitosa

{
  "numero_guia":"0019999999703610019220",
  "codigo_rastreo":"1872996868",
  "servicio":"Entrega garantizada al siguiente d\u00eda h\u00e1bil (lunes a viernes)",
  "fecha_programada":"29\/06\/2012",
  "origen":{
    "nombre":"Cd. Ju\u00e1rez",
    "latitud":31.7311292,
    "longitud":-106.4625624
  },
  "fecha_recoleccion":"28\/06\/2012",
  "hora_recoleccion":"01:12 PM",
  "destino":{
    "nombre":"MEXICO D.F.",
    "latitud":19.4326077,
    "longitud":-99.133208,
    "codigo_postal":"01210"
  },
  "estatus_envio":"Entregado",
  "fecha_entrega":"03\/07\/2012",
  "hora_entrega":"05:01 PM"
}

Se incluye un ejemplo de aplicación web que consume los servicios de la API para mostrar en un mapa el origen y destino del envío con otra información. Esta aplicación también puede recibir un número de guía o código de rastreo en la URL, por ejemplo:

http://localhost/EstafetaAPI/client/?numero=1872996868