A Correos gestionem els teus enviaments perquè només hagis de preocupar-te del teu negoci.
Per integrar-se amb les API de Correos, és necessari firmar contracte de transport
Passos per accedir al Portal de Desenvolupadors
Per poder accedir al Portal de Desenvolupadors, on podràs començar a utilitzar les API de Correos, has de seguir aquests passos:
1. Per poder accedir al Portal de Desenvolupadors, t’hauràs de donar d’alta a CorreosID. Deixem a la teva disposició el manual de registre perquè t’ajudi en el procés.
2. Accedeix al Portal de Desenvolupadors i sol·licita accés a les API que vulguis gestionar. Deixem a la teva disposició el manual d’accés a API perquè t’ajudi en el procés.
3. Com a documentació de suport, pots descarregar també la Matriu d’esdeveniments.
En què consisteix la integració per API?
La integració per API permet una gestió total dels enviaments que agilitza la logística, la gestió de magatzem i l’Atenció al Client. Està recomanada especialment per a clients amb un volum d’enviaments diaris elevat, els que ja utilitzen aquesta integració amb altres proveïdors i els que ja tenen una gestió logística molt automatitzada.
Aquest servei està disponible per a molts dels nostres productes:
Paqueteria nacional:
Paqueteria internacional:
També disposaràs d’una gran varietat de funcionalitats:
Redueix el temps que dediques a la gestió dels enviaments amb el nostre servei de lliurament. Des de Correos ens encarreguem de tot perquè puguis dedicar els teus esforços al teu negoci.
Si encara no n’ets client, posa’t en contacte amb el nostre servei d’Atenció al Client al 915 197 197 i t’informarem.
Com utilitzar OAuth 2.0 per accedir a les API de Correos
Passos bàsics:
1. Obtén credencials d’OAuth 2.0 de CorreosID
2. Obtén un token d’accés del servidor d’autorització de Correos
3. Envia el token d’accés a una API
4. Actualitza el token d’accés si és necessari
Nota: L’ús de la implementació de Correos d’OAuth 2.0 es regeix per les Polítiques d’OAuth 2.0.
Després, la teva aplicació client sol·licita un token d’accés al servidor d’autorització de Correos, extreu un token de la resposta i l’envia a l’API de Correos a la qual vols accedir.
1. Obtén credencials d’OAuth 2.0 de CorreosID
Una vegada completat el procés de registre a CorreosID, obtindràs credencials de client d’OAuth 2.0 (client_id i client_secret).
2. Obtén un token d’accés del servidor d’autorització de Correos
Abans que la teva aplicació pugui accedir a dades privades amb una API de Correos, ha d’obtenir un token d’accés que li atorgui accés a aquesta API. Un sol token d’accés pot atorgar diferents graus d’accés a diverses API. Un paràmetre variable anomenat scope controla el conjunt de recursos i operacions que permet un token d’accés. Durant la sol·licitud de token d’accés, la teva aplicació envia un o més valors en el paràmetre scope.
Si s’atorga almenys un permís, el servidor d’autorització de Correos envia a la teva aplicació un token d’accés.
3. Envia el token d’accés a una API
Després que una aplicació hagi obtingut un token d’accés, l’envia a una API de Correos en un encapçalament de sol·licitud d’autorització HTTP. És possible enviar tokens com a paràmetres de cadena de consulta d’URI, però no ho recomanem, ja que els paràmetres d’URI poden acabar en fitxers de registre que no són completament segurs. A més, és una bona pràctica de REST evitar crear noms de paràmetres d’URI innecessaris.
Els tokens d’accés només són vàlids per al conjunt d’operacions i recursos que es descriuen en el paràmetre scope de la sol·licitud del token. Per exemple, si s’emet un token d’accés per a l’API Preregister, no s’atorga accés a l’API Requests. Tanmateix, pots enviar aquest token d’accés a l’API Preregister diverses vegades per fer operacions similars.
Una vegada completada la sol·licitud d’accés a l’API al Portal de Desenvolupadors, obtindràs client_id i client_secret d’API, que hauràs d’incloure en la petició a més del token d’accés.
4. Actualitza el token d’accés, si és necessari
Els tokens d’accés tenen una vida útil limitada. Si la teva aplicació necessita accedir a una API de Correos més enllà del cicle de vida d’un token d’accés, pot obtenir un token d’accés nou.