Primeros pasos

Tu primera petición en 4 pasos

Pasa de cero a una llamada real contra la REST API de Openprovider.

1

Crea una cuenta y activa el acceso a la API

Necesitas una cuenta de reseller activa. Inicia sesión en el panel de control, o crea una, para obtener tu nombre de usuario y tu contraseña.

El acceso a la API está desactivado por defecto y se activa por persona de contacto. En el panel de control ve a Resumen de la cuenta → Personas de contacto → y elige Añadir persona de contacto o selecciona una existente → pestaña API → Activar el acceso a la API.

Para las operaciones con dominios puede que necesites firmar contratos concretos del registro antes de empezar. Consúltalos en Cuenta → Contratos.

2

Autentícate para obtener un bearer token

Envía tus credenciales al endpoint /auth/login. La respuesta devuelve un token que usarás para autorizar todas las peticiones siguientes.

curl -X POST https://api.openprovider.eu/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "you@example.com",
    "password": "your-password",
    "ip": "0.0.0.0"
  }'

El token se devuelve en data.token y tiene una validez limitada. Guárdalo en caché y reutilízalo entre peticiones en lugar de autenticarte en cada llamada.

3

Haz tu primera llamada autorizada

Pasa el token en la cabecera Authorization como bearer token. Aquí comprobamos si un dominio está disponible:

curl -X POST https://api.openprovider.eu/v1/domains/check \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [{ "name": "mybrand", "extension": "com" }]
  }'
4

Explora la referencia completa de la API

Consulta todos los endpoints, esquemas de petición y ejemplos de respuesta en la documentación interactiva, o importa la especificación OpenAPI en Postman.

URL base y convenciones

ElementoValor
URL basehttps://api.openprovider.eu/v1
ProtocoloSolo HTTPS
FormatoCuerpos de petición y respuesta en JSON
AutenticaciónAuthorization: Bearer <token>
MétodosGET, POST, PUT, DELETE

Estructura de la respuesta

Las respuestas correctas envuelven el payload en una estructura predecible con un code numérico (0 indica éxito) y un objeto data:

{
  "code": 0,
  "data": { /* result */ },
  "desc": ""
}

Un code distinto de cero indica un error. Revisa desc para leer el mensaje descriptivo y gestiona los fallos con elegancia en tu integración.