Saltearse al contenido

Inicio rápido

Esta página te lleva de cero a una consulta funcionando contra NamiDB Cloud en pocos minutos. Si prefieres ejecutar el motor tú mismo, consulta Self-hosted.

1. Crea una cuenta y una organización

  1. Ve a app.namidb.com/signup. Regístrate con tu nombre, tu email y una contraseña (de al menos 10 caracteres), o con GitHub o Google cuando estén disponibles.

  2. Confirma tu dirección. El email trae un enlace y un código de 6 dígitos; cualquiera de los dos sirve, una sola vez, durante 15 minutos.

  3. Ponle nombre a tu organización. La organización es tu espacio de trabajo: es dueña de las bases de datos, las API keys, los miembros y la facturación. También puedes elegir dónde vive su almacenamiento, o dejar el valor por defecto (el más cercano a ti).

Las organizaciones nuevas empiezan en el plan Free. No se cobra nada hasta que un owner elige un plan pago y completa el checkout. Consulta Facturación.

2. Crea una base de datos

En la consola, abre Databases → Create database y llámala movies. Los nombres usan letras minúsculas, números, - y _, empiezan con una letra o un número y tienen como máximo 63 caracteres.

La página de la base de datos se abre en su pestaña Connect, que muestra el endpoint HTTPS y la URI de Bolt con fragmentos listos para copiar. Una base de datos vacía también ofrece Load sample dataset en la pestaña Query: un pequeño grafo de películas para probar consultas.

3. Crea una API key

Abre API keys → Create key:

  • Name: algo que diga dónde se usa, como quickstart.
  • Access: Read & write para esta guía. Usa Read only para todo lo que solo lee.
  • Databases: All databases, o solo movies.
  • Expires: 90 días por defecto.

La key tiene la forma nmdb_live_… y se muestra una sola vez. Cópiala ahora en una variable de entorno:

Ventana de terminal
export NAMIDB_API_KEY=nmdb_live_…

NamiDB guarda solo un hash con clave de ella. Si la pierdes, revócala y crea una nueva. Más detalles en API keys y tokens de gestión.

4. Ejecuta tu primera consulta

Ventana de terminal
curl https://db.namidb.com/v1/movies/cypher \
-H "Authorization: Bearer $NAMIDB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "CREATE (:Movie {title: $title, released: $year})", "params": {"title": "Heat", "year": 1995}}'
curl https://db.namidb.com/v1/movies/cypher \
-H "Authorization: Bearer $NAMIDB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "MATCH (m:Movie) RETURN m.title AS title, m.released AS year"}'
{"columns": ["title", "year"], "rows": [{"title": "Heat", "year": 1995}]}

La primera consulta después de un periodo sin actividad puede tardar un momento mientras la base de datos despierta. Los SDKs y los drivers lo esperan; consulta Escalado a cero.

5. Mírala en la consola

Abre la pestaña Query de la base de datos y ejecuta:

MATCH (m:Movie) RETURN m

Cambia el resultado a Graph para ver los nodos, o a Table y JSON para ver los valores crudos. La pestaña Metrics muestra las lecturas y escrituras a medida que ocurren, y Usage las muestra frente a la cuota de tu plan.

Próximos pasos