Credenciales y primera llamada

Obtén tus credenciales

Las credenciales (un usuario y un secreto) las genera y te las entrega WelcomeSims: no puedes crearlas tú. Hay unas para cada entorno (PRE y PRO) y cada punto de conexión tiene las suyas, asociadas a tu oficina.

Al darte de alta guardamos un correo de contacto. Lo usamos para avisarte de los cambios de la API (consulta el historial de cambios). Si cambia, díselo a WelcomeSims.
El secreto te lo entregamos una sola vez: ni nosotros podemos volver a leerlo. Guárdalo en un gestor de secretos o en variables de entorno; no lo incluyas en el código ni en el repositorio.
Si lo pierdes o crees que se ha filtrado, avísanos: generamos uno nuevo y el anterior deja de funcionar al instante. Si no quieres un corte, podemos darte una segunda credencial, que cambies cuando te venga bien, y desactivar después la antigua.

Autenticación

Todas las peticiones llevan HTTP Basic: la cabecera Authorization con usuario:secreto codificado en Base64. La mayoría de clientes HTTP lo hacen por ti:

curl -u "mi-usuario:mi-secreto" "https://pre-api.welcomesims.com/public-api/v1/countries"

O con la cabecera explícita:

curl "https://pre-api.welcomesims.com/public-api/v1/countries" \
  -H "Authorization: Basic $(printf '%s' 'mi-usuario:mi-secreto' | base64)"

Tu primera llamada

Lista los países a los que puedes vender:

curl -s -u "mi-usuario:mi-secreto" \
  "https://pre-api.welcomesims.com/public-api/v1/countries"

Si todo va bien recibes 200 y una lista de países como esta (aquí, recortada):

[
  { "id": 83, "name": "Japón", "code": "JP" }
]

Si recibes un error

Respuesta	Qué significa
`401` con `"code": "UNAUTHORIZED"`	Credenciales ausentes, incorrectas o desactivadas. Por seguridad la respuesta es la misma en los tres casos.
`503` con `"code": "SERVICE_UNAVAILABLE"`	El servicio no ha podido procesar la petición. Reintenta pasados unos segundos.

Siguiente paso: la guía completa del flujo.