Resumen de la API

La API de Linka esta organizada sobre REST. Usa URLs predecibles orientadas a recursos, acepta cuerpos JSON, devuelve respuestas JSON y trabaja con codigos, verbos HTTP y autenticacion estandar.

URLs de ambiente

Ambiente	URL base	Uso
Sandbox	`https://api.sandbox.linka.xyz/v1`	Desarrollo y pruebas
Produccion	`https://api.linka.xyz/v1`	Transacciones reales

Verbos HTTP

Usamos verbos HTTP estandar para expresar la accion:

GET: consultar un recurso o una lista de recursos. POST: crear un recurso o ejecutar un proceso. PUT: actualizar un recurso existente. DELETE: eliminar un recurso.

Formato de respuesta

Todas las respuestas usan un objeto superior comun para mantener consistencia.

Respuesta exitosa

{
  "data": {
    "id": "res_123",
    "object": "wallet",
    "status": "active"
  },
  "request_id": "req_abc987"
}

Respuesta de error

{
  "error": {
    "type": "invalid_request_error",
    "message": "The amount must be greater than 0.",
    "code": "parameter_invalid"
  },
  "request_id": "req_abc987"
}

Paginacion

Las listas de recursos estan paginadas. Usa los parametros limit y offset para controlar los resultados.

Limite por defecto: 20.
Limite maximo: 100.

GET /v1/payments?limit=50&offset=100

Rate limiting

Para mantener la estabilidad de la plataforma, aplicamos limites de uso a todas las API keys.

Sandbox: 10 solicitudes por segundo.
Produccion: 100 solicitudes por segundo, ajustable segun el plan.

Si excedes estos limites, la API devolvera un estado 429 Too Many Requests.

SDKs

Puedes usar cualquier cliente HTTP. Tambien ofrecemos SDKs oficiales para acelerar la integracion: