En Correos xestionamos os teus envíos para que só teñas que preocuparte do teu negocio.
Para integrase coas API de Correos é necesario asinar contrato de transporte
Pasos para acceder ao Portal de Desenvolvedores
Para poder acceder ao Portal de Desenvolvedores, onde poderás comezar a utilizar as API de Correos, debes de realizar os seguintes pasos:
1. Para poder acceder ao Portal de Desenvolvedores, deberás darte de alta en CorreosID. Deixamos á túa disposición o manual de rexistro como axuda no proceso.
2. Accede ao Portal de Desenvolvedores e solicita acceso ás API que queiras xestionar. Deixamos á túa disposición o manual de acceso a API como axuda no proceso.
3. Como documentación de apoio, podes descargar, tamén, a Matriz de eventos.
En que consiste a integración por API?
A integración por API permite unha xestión total dos envíos que axiliza a loxística, a xestión de almacén e a Atención ao Cliente. Está especialmente recomendada para clientes cun volume de envíos diarios elevado, os que xa usan esta integración con outros provedores e aqueles cuxa xestión loxística está moi automatizada.
Este servizo está dispoñible para moitos dos nosos produtos:
Paquetería Nacional:
Paquetería Internacional:
Tamén dispoñerás dunha gran variedade de funcionalidades:
Reduce o tempo que dedicas á xestión dos envíos co noso servizo de entrega. Dende Correos encargámonos de todo para que poidas dedicar os teus esforzos ao teu negocio.
Se aínda non es cliente, contacta co noso servizo de Atención ao Cliente no 915 197 197 e informámoste.
Como usar OAuth 2.0 para acceder ás API de Correos
Pasos básicos:
1. Obtén credenciais de OAuth 2.0 de CorreosID
2. Obtén un token de acceso do servidor de autorización de Correos
3. Envía o token de acceso a un API
4. Actualiza o token de acceso se é necesario
Nota: O uso da implementación de Correos de OAuth 2.0 réxese polas Políticas de OAuth 2.0.
Logo, a túa aplicación cliente solicita un token de acceso ao servidor de autorización de Correos, extrae un token da resposta e envíao á API de Correos á que desexas acceder.
1. Obtén credenciais de OAuth 2.0 de CorreosID
Unha vez completado o proceso de rexistro en CorreosID obterás credenciais de cliente de OAuth 2.0 (client_id e client_secret).
2. Obtén un token de acceso do servidor de autorización de Correos
Antes de que a túa aplicación poida acceder a datos privados cunha API de Correos, debe obter un token de acceso que lle outorgue acceso a esa API. Un só token de acceso pode outorgar diferentes graos de acceso a varias API. Un parámetro variable chamado scope controla o conxunto de recursos e operacións que permite un token de acceso. Durante a solicitude de token de acceso, a túa aplicación envía un ou máis valores no parámetro scope.
Se se outorga polo menos un permiso, o servidor de autorización de Correos envíalle á túa aplicación un token de acceso.
3. Envía o token de acceso a unha API
Despois de que unha aplicación obtén un token de acceso, envíao a unha API de Correos nun encabezado de solicitude de autorización HTTP. É posible enviar tokens como parámetros de cadea de consulta de URI, pero non o recomendamos, xa que os parámetros de URI poden rematar en arquivos de rexistro que non son completamente seguros. Ademais, é unha boa práctica de REST evitar crear nomes de parámetros de URI innecesarios.
Os tokens de acceso só son válidos para o conxunto de operacións e recursos que se describen no scope da solicitude do token. Por exemplo, se se emite un token de acceso para a API Preregister non se outorga acceso á API Requests. Non obstante, podes enviar ese token de acceso á API Preregister varias veces para realizar operacións similares.
Unha vez completada a solicitude de acceso á API no Portal de Desenvolvedores obterás client_id e client_secret de API, que deberás incluír na petición ademais do token de acceso.
4. Actualiza o token de acceso, se é necesario
Os tokens de acceso teñen unha vida útil limitada. Se a túa aplicación necesita acceder a unha API de Correos máis alá do ciclo de vida dun token de acceso, pode obter un token de acceso novo.