Negociación = Recursos + Tiempo + Flexibilidad
Recuerda en cualquier negociación lo que estamos buscando siempre es el punto de equilibrio entre los recursos percibidos, el tiempo invertido y la flexibilidad disponible.
timegrep: Very useful grep tool
Specially when you have to look up inside Postfix logs or Syslog in general it could be the swiss knife tool you need: timegrep.
You have to know that the tool is developed using Python. And is very easy to upgrade or fork the code.
Some recommendations about RESTful API design
I want to recommend to you to watch the YouTube video called RESTful API design of Brian Mulloy. In this post I make an small abstract of the most important ideas of the video, of course from my point of view:
- Use concrete plural nouns when you are defining resources.
- Resource URL has to be focused in access collection of elements and specific element. Example:
- /clients – get all clients
- /clients/23 – get the client with ID 23
- Map HTTP methods to maintein elements (CRUD):
- POST – CREATE
- GET – READ
- PUT – UPDATE
- DELETE – DELETE
- Workaround, if your REST client doesn’t support HTTP methods, use a parameter called ‘method’ could be a good idea. For example, when you have to use a method HTTP PUT it could be changed by method HTTP GET and the parameter ‘method=put’ in the URL.
- Sweep complexity behind the ‘?’. Use URL parameters to filter or put some optional information to your request.
- How to manage errors:
- Use HTTP response codes to refer error codes. You can find a list of HTTP response codes in Wikipedia.
JSON response example can be like this:<br><pre>{ 'message':'problem description', 'more_info':'http://api.domain.tld/errors/12345' }</pre><br>Workaround, if REST client doesn’t know how to capture HTTP error codes and raise up an error losing the control of the client, you can use HTTP response code 200 and put ‘response_code’ field in JSON response object. It’s a good idea use this feature as optional across URL parameter ‘supress_response_code=true’.
Versioning the API. Use a literal ‘v’ followed by an integer number before the resource reference in the URL. It could be the most simple and powerful solution in this case. Example: /v1/clients/
The selection of what information will be returned in the response can be defined in the URL parameters, like in this example: /clients/23?fields=name,address,city
Pagination of the response. Use the parameters ‘limit’ and ‘offset’, keep simple. Example: ?limit=10&offset=0
Format of the answer, in this case I’m not completely agree with Brian. I prefer to use HTTP header ‘Accept’ than his proposal. Anyway both ideas are:
- Use HTTP header ‘Accept’ with proper format request in the answer, for example, ‘Accept: application/json’ when you want a JSON response.
- or, use extension ‘.json’ in URL request to get the response in JSON format.
- Use Javascript format for date and time information, when you are formatting JSON objects.
Sometimes APIs need to share actions. Then we can’t define an action with a noun, in this case use verb. Is common to need actions like: convert, translate, calculate, etc.
Searching, there are two cases:
- Search inside a resource, in this case use parameters to apply filters.
- Search across multiple resource, here is useful to create the resource ‘search’.
- Count elements inside a resource, simply add ‘/count’ after the resource. Example: /clients/count
- As far as you can use a single base URL for all API resources, something like this: ‘http://api.domain.tld’.
- Authentication, simply use OAuth 2.0
To keep your API KISS usually it’s a good idea develop SDK in several languages, where you can put more high level features than in API.
Inside an application each resource has its own API but it’s not a good idea publish it to the world, maybe use a virtual API in a layer above it’s more secure and powerful.
Changing Ubuntu CLI language
My mother tongue is Catalan and of course I speak and understand Spanish very well, but when I’m using a Linux CLI it’s impossible to be agile if the interface is not in English. Then when I need to change Ubuntu interface to English I modify the file /etc/default/locale:
LANG=en_US.UTF-8 LANGUAGE="en_US:en"
Avui el blog fa 12 anys
Avui el blog ha arribat a la nova fita dels 12 anys. Cal dir que ja fa anys que pobret esta tocat ja que les obligacions impedeixen trobar temps pels hobbies; tot i amb això, pel que a mi respecte el considero més viu que mai. La raó és ben senzilla tinc més d’un instint al dia d’escriure coses que finalment no s’acaba podent materialitzar degut a la quantitat de temps que cal dedicar a cada entrada.
Així doncs, amb els meus millors desitjos i esforços continuaré treballant i esforçant-me dia a dia per canviar aquesta dinàmica, gràcies a tots els que em seguiu.
Ejercicio para amenazas no físicas
Esta semana estoy terminando la lectura del libro “Ahora YO, ¿y si creas tu propio futuro en lugar de encontrártelo?” del Dr. Mario Alonso Puig. Al finalizar el libro me gustaría hacer una pequeña reseña de los muchos e interesantes contenidos que se nos presentan. Pero ahora mismo lo que me gustaría hacer es un pequeño resumen a modo de bloc de notas de un fragmento de su libro donde se nos explica qué hace que situaciones que no son de peligro físico activen nuestros mecanismos de defensa y cómo podemos cambiar nuestras reacciones ante estas circunstancias.
A menudo podríamos decir que vivimos en una constante tensión porqué de forma simultánea tenemos que proteger el cuerpo físico, mostrar la imagen quien se espera que seamos y esconder la imagen de lo que tememos ser. Como se puede imaginar este trabajo produce un importante desgaste y acaba repercutiendo en nuestra vitalidad y salud. A menudo se habla del miedo al cambio, hoy en día rara vez este miedo tiene que ver con la supervivencia física. Pero si que acostumbra a tener una fuerte relación con la imagen de nosotros que queremos proteger.
Así pues la estrategia que se nos propone en el libro sobre la sensación de amenaza que sentimos al proteger nuestra imagen. Cabe recordar que cuando se siente una amenaza física se activan unos mecanismos de ataque, huida y bloqueo. Estos mecanismos han sido muy útiles a lo largo de la evolución para protegernos de las amenazas físicas pero cuando entramos en estados de amenaza por temas no físicos estos mecanismos instintivos no nos sirven de nada, al contrario, nos perjudican.
Una estrategia para evitar estas reacciones es:
- Poner en marcha dos elementos. El elemento mental es la aceptación y el físico el control de la respiración. Al sentir miedo porqué creemos que nuestra imagen esta amenazada, el miedo a la crítica, desilusionar a otros, al que dirán, etc. En estas situaciones la aceptación consiste en hacer el ejercicio de observarnos desde fuera, proyectar nuestra imagen vista desde fuera para observar cuales son nuestras reacciones. Observando las reacciones del cuerpo, cambios en la respiración, aumento de la tensión. Se trata de establecer un distanciamiento entre las emociones que estamos experimentando y el hecho de ser también observadores de estas reacciones como si no fueran propias. A este proceso de observación se le llama meta-atención.
- Control de la respiración. Cuando el miedo se apodera de nosotros el primer elemento que cambia es la respiración. A menudo esta se acelera o por el contrario dejamos de respirar es la llamada taquipnea. Para lograr tomar el control podemos ir cogiendo aire de manera consciente y después ir soltándolo con una espiración más larga que la inspiración. Es importante sentir que el abdomen se hincha. Cuando vayamos notando que el control sobre la respiración aumenta podemos decir la palabra uno al inspirar y también al espirar. Llegados a este punto debemos imaginar que un aire de color azul entra por nuestra nariz, llena los pulmones y finalmente llega a los riñones.
Es interesante saber porqué este ejercicio funciona. La respiración controlada y acompasada manda un mensaje al cerebro de que todo va bien. Al decir la palabra uno al inspirar y espirar obliga al cerebro a concentrarse en la respiración dejando sin espacio a aquello que nos ocupa. El color azul es procesado por el hemisferio derecho del cerebro y este lo procesa como una señal de tranquilidad y armonía. No hay que olvidar que los miedos son en gran parte fruto de nuestro inconsciente y la forma más rápida de conectar con esta parte de nuestro ser es a través del hemisferio derecho.
En una segunda fase la pregunta que nos deberíamos hacer es: “¿qué me estoy haciendo para sentirme así?” la respuesta a esta pregunta debemos dejar que nos llegue desde el inconsciente. Debemos estar muy atentos y abiertos. Porqué en el inconsciente hay dos fuerzas una que nos anula y otra que nos ayuda. La que nos anula se ha ido alimentando de los pensamientos tóxicos que hemos recogido de nuestro entorno y de la cultura.
Para acabar estas notas quiero parafrasear el siguiente concepto: “Quien de verdad es compasivo entiende que todo el daño que nos causamos los hombres a nosotros mismos y a los demás no es por una maldad intrínseca, sino porque vivimos asustados, nos sentimos acorralados y eso nos torna intolerantes y agresivos.“