correios-api

correios-api copied to clipboard

h1. correios-api

correios-api é uma API de webservices REST e Ruby para rastrear encomendas dos Correios.

Esta API faz requests e parse no HTML do site dos correios para fornecer informações sobre encomendas.

Para mais informações acesse o "site do projeto":http://guilhermechapiewski.github.com/correios-api.

h2. Usando a API Rest

Se você acessar o endereço:

http://localhost:4567/encomenda/ES446391025BR

Você receberá um XML com os dados da encomenda "ES446391025BR":

 xml encoding="UTF-8" version="1.0" ?>

  
    ACF FENIX - ITAPECERICA DA SERRA/SP
    Postado
    
  
  
    ACF FENIX - ITAPECERICA DA SERRA/SP
    Encaminhado
    Em trânsito para CTE JAGUARE - SAO PAULO/SP
  
  
    CTE JAGUARE - SAO PAULO/SP
    Encaminhado
    Encaminhado para CTE SAUDE - SAO PAULO/SP
  
  
    CTE SAUDE - SAO PAULO/SP
    Encaminhado
    Encaminhado para CEE MOEMA - SAO PAULO/SP
  
  
    CEE MOEMA - SAO PAULO/SP
    Saiu para entrega
    
  
  
    CEE MOEMA - SAO PAULO/SP
    Entregue
    
  

h2. Usando a API Ruby

require "rubygems"
require "correios"
encomenda = Correios.encomenda("ES446391025BR")
puts encomenda.numero
encomenda.status.each do |status|
  puts status.data
  puts status.local
  puts status.situacao
  puts status.detalhes
end

Outra forma de uso útil:

encomenda = Correios.encomenda("ES446391025BR")
puts encomenda.ultimo_status_disponivel.to_s

h2. Números de rastreamento para teste

Outros números de encomenda para teste:

• RO811226537BR
• EC834786906BR
• SO376590583BR
• EC884014459BR
• EC726225124BR