SDKs y Librerias
Integra WardOps en tu aplicacion usando nuestros SDKs oficiales. Disponibles para los lenguajes de programacion mas populares.
SDKs para Servidor
@wardops/sdkInstalacion
npm install @wardops/sdkEjemplo de uso
1import { WardOps } from '@wardops/sdk';2 3const client = new WardOps({4 apiKey: process.env.WARDOPS_API_KEY5});6 7// Listar guardias8const guards = await client.guards.list({9 status: 'active',10 perPage: 2511});12 13// Crear una asignacion14const assignment = await client.assignments.create({15 guardId: 'grd_123abc',16 postId: 'pst_789xyz',17 startTime: new Date('2024-01-26T08:00:00Z'),18 endTime: new Date('2024-01-26T20:00:00Z')19});20 21// Escuchar eventos en tiempo real22client.realtime.subscribe('locations', (event) => {23 console.log('Ubicacion actualizada:', event.data);24});wardopsInstalacion
pip install wardopsEjemplo de uso
1from wardops import WardOps2import os3 4client = WardOps(api_key=os.environ['WARDOPS_API_KEY'])5 6# Listar guardias7guards = client.guards.list(status='active', per_page=25)8 9for guard in guards.data:10 print(f"{guard.first_name} {guard.last_name}")11 12# Crear una asignacion13assignment = client.assignments.create(14 guard_id='grd_123abc',15 post_id='pst_789xyz',16 start_time='2024-01-26T08:00:00Z',17 end_time='2024-01-26T20:00:00Z'18)19 20# Webhook handler con Flask21from wardops.webhook import verify_signature22 23@app.route('/webhooks/wardops', methods=['POST'])24def handle_webhook():25 if not verify_signature(request, os.environ['WEBHOOK_SECRET']):26 return 'Invalid signature', 40127 28 event = request.json29 print(f"Evento: {event['event']}")30 return 'OK', 200wardops/wardops-phpInstalacion
composer require wardops/wardops-phpEjemplo de uso
1<?php2 3use WardOps\WardOps;4 5$client = new WardOps([6 'api_key' => getenv('WARDOPS_API_KEY')7]);8 9// Listar guardias10$guards = $client->guards->list([11 'status' => 'active',12 'per_page' => 2513]);14 15foreach ($guards->data as $guard) {16 echo "{$guard->first_name} {$guard->last_name}\n";17}18 19// Crear una asignacion20$assignment = $client->assignments->create([21 'guard_id' => 'grd_123abc',22 'post_id' => 'pst_789xyz',23 'start_time' => '2024-01-26T08:00:00Z',24 'end_time' => '2024-01-26T20:00:00Z'25]);26 27// Verificar webhook28use WardOps\Webhook;29 30$payload = file_get_contents('php://input');31$signature = $_SERVER['HTTP_X_WARDOPS_SIGNATURE'];32$timestamp = $_SERVER['HTTP_X_WARDOPS_TIMESTAMP'];33 34if (Webhook::verify($payload, $signature, $timestamp, $secret)) {35 $event = json_decode($payload, true);36 // Procesar evento37}github.com/wardops/wardops-goInstalacion
go get github.com/wardops/wardops-goEjemplo de uso
1package main2 3import (4 "context"5 "fmt"6 "os"7 8 "github.com/wardops/wardops-go"9)10 11func main() {12 client := wardops.NewClient(os.Getenv("WARDOPS_API_KEY"))13 ctx := context.Background()14 15 // Listar guardias16 guards, err := client.Guards.List(ctx, &wardops.GuardListParams{17 Status: wardops.String("active"),18 PerPage: wardops.Int(25),19 })20 if err != nil {21 panic(err)22 }23 24 for _, guard := range guards.Data {25 fmt.Printf("%s %s\n", guard.FirstName, guard.LastName)26 }27 28 // Crear asignacion29 assignment, err := client.Assignments.Create(ctx, &wardops.AssignmentCreateParams{30 GuardID: "grd_123abc",31 PostID: "pst_789xyz",32 StartTime: time.Date(2024, 1, 26, 8, 0, 0, 0, time.UTC),33 EndTime: time.Date(2024, 1, 26, 20, 0, 0, 0, time.UTC),34 })35}wardopsInstalacion
gem install wardopsEjemplo de uso
1require 'wardops'2 3WardOps.api_key = ENV['WARDOPS_API_KEY']4 5# Listar guardias6guards = WardOps::Guard.list(status: 'active', per_page: 25)7 8guards.data.each do |guard|9 puts "#{guard.first_name} #{guard.last_name}"10end11 12# Crear asignacion13assignment = WardOps::Assignment.create(14 guard_id: 'grd_123abc',15 post_id: 'pst_789xyz',16 start_time: Time.new(2024, 1, 26, 8, 0, 0, '+00:00'),17 end_time: Time.new(2024, 1, 26, 20, 0, 0, '+00:00')18)19 20# Webhook handler con Rails21class WebhooksController < ApplicationController22 def wardops23 if WardOps::Webhook.verify(request)24 event = JSON.parse(request.body.read)25 # Procesar evento26 head :ok27 else28 head :unauthorized29 end30 end31endSDKs para Movil
SDKs especializados para aplicaciones moviles con soporte para ubicacion en segundo plano y notificaciones push.
npm install @wardops/react-nativepod 'WardOpsSDK'implementation 'com.wardops:sdk:1.0.0'Nota: Los SDKs moviles incluyen funcionalidades especiales como tracking de ubicacion en segundo plano, geofencing y manejo de notificaciones push. Consulta la documentacion especifica de cada SDK para mas detalles.
Inicio Rapido
Ejemplos basicos para comenzar a usar los SDKs rapidamente.
Listar guardias activos
import { WardOps } from '@wardops/sdk';
const client = new WardOps({
apiKey: process.env.WARDOPS_API_KEY
});
async function main() {
const guards = await client.guards.list({
status: 'active'
});
console.log(`Total: ${guards.meta.total} guardias`);
for (const guard of guards.data) {
console.log(`- ${guard.firstName} ${guard.lastName}`);
}
}
main();Escuchar eventos en tiempo real
import { WardOps } from '@wardops/sdk';
const client = new WardOps({
apiKey: process.env.WARDOPS_API_KEY
});
// Conectar a WebSocket
const realtime = client.realtime.connect();
// Suscribirse a eventos de check-in
realtime.subscribe('checkins', (event) => {
console.log(`Check-in: ${event.data.guardName}`);
console.log(`Puesto: ${event.data.postName}`);
console.log(`Hora: ${event.data.timestamp}`);
});
// Suscribirse a alertas
realtime.subscribe('alerts', (event) => {
console.log(`ALERTA: ${event.data.message}`);
});
// Manejar errores
realtime.on('error', (error) => {
console.error('Error de conexion:', error);
});Caracteristicas de los SDKs
Comunidad
Contribuye a los SDKs o reporta problemas en nuestros repositorios de GitHub.
Tu lenguaje no esta aqui?
Siempre puedes usar nuestra API REST directamente. Tambien aceptamos contribuciones para nuevos SDKs.