En Correos gestionem els teus enviaments perquè només hages de preocupar-te del teu negoci.
Per a integrar-se amb les API de Correos és necessari signar contracte de transport
Passos per a 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 fer els passos següents:
1. Per poder accedir al Portal de Desenvolupadors, t’has de donar d’alta a CorreosID. Deixem a la teua disposició el manual de registre perquè t'ajude en el procés.
2. Accedix al Portal de Desenvolupadors i sol·licita accés a les API que vulgues gestionar. Deixem a la teua disposició el manual d'accés a API perquè t'ajude en el procés.
3. Com a documentació de suport, també es pot baixar la Matriu d'esdeveniments.
En què consistix la integració per API?
La integració per API permet una gestió total dels enviaments que agilita la logística, la gestió de magatzem i l’atenció al client. Està especialment recomanada per a clients amb un volum d’enviaments diaris elevat, els que ja utilitzen esta integració amb altres proveïdors i aquells la gestió logística dels quals està molt automatitzada.
Este servei està disponible per a molts dels nostres productes:
Paqueteria nacional:
Paqueteria internacional:
També disposaràs d’una gran varietat de funcionalitats:
Reduïx el temps que dediques a la gestió dels enviaments amb el nostre servei de lliurament. Des de Correos ens encarreguem de tot perquè pugues dedicar els teus esforços al teu negoci.
Si encara no eres client, contacta amb el nostre servei d’Atenció al client en el 915 197 197 i t’informem.
Com utilitzar OAuth 2.0 per a accedir les API de Correos
Passos bàsics:
1. Obtingues credencials d’OAuth 2.0 de CorreosID
2. Obtingues 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 cal
Nota: L'ús de la implementació de Correos d'OAuth 2.0 es regix per les Polítiques d'OAuth 2.0.
Després, la teua aplicació client sol·licita un token d’accés al servidor d’autorització de Correos, extrau un token de la resposta i l’envia a l’API de Correos al qual vols accedir.
1. Obtingues 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. Obtingues un token d'accés del servidor d'autorització de Correos
Abans que la teua aplicació puga accedir a dades privades amb una API de Correos, ha d’obtindre un token d’accés que li atorgue accés a eixa 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 teua 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 li envia a la teua aplicació un token d’accés.
3. Envia el token d’accés a una API
Després que una aplicació obté un token d'accés, ho 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 arxius 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 l' 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 este 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 cal
Els tokens d'accés tenen una vida útil limitada. Si la teua aplicació necessita accedir a una API de Correos més enllà del cicle de vida d’un token d’accés, pot obtindre un token d’accés nou.