**Integratiegids voor WeatherAPI met Stripe en Twilio** --- ## Inhoudsopgave 1. Introductie 2. Algemene richtlijnen voor integratie 3. Authenticatie en beveiliging 4. Integratie met Stripe - Stap 1: API-sleutel verkrijgen - Stap 2: Stripe SDK installeren - Stap 3: Betalingen verwerken - Voorbeeldcode - Valkuilen en best practices 5. Integratie met Twilio - Stap 1: Twilio-account en API-sleutel - Stap 2: Twilio SDK installeren - Stap 3: SMS-berichten verzenden - Voorbeeldcode - Valkuilen en best practices 6. Veelvoorkomende problemen en oplossingen 7. Conclusie --- ## 1. Introductie Deze gids helpt ontwikkelaars om de WeatherAPI te integreren met twee populaire diensten: Stripe voor betalingsverwerking en Twilio voor communicatie. We behandelen de stappen, codevoorbeelden, valkuilen en tips voor een succesvolle integratie. --- ## 2. Algemene richtlijnen voor integratie - Gebruik altijd de nieuwste versies van SDK's en API's. - Beveilig je API-sleutels en tokens. - Test integraties in sandbox- of testomgevingen voordat je live gaat. - Lees de documentatie van derden voor de laatste updates en best practices. --- ## 3. Authenticatie en beveiliging - Gebruik API-sleutels en OAuth waar mogelijk. - Beperk de rechten van API-sleutels tot het minimale benodigde. - Gebruik HTTPS voor alle communicatie. - Implementeer inputvalidatie en foutafhandeling. --- ## 4. Integratie met Stripe ### Stap 1: API-sleutel verkrijgen - Maak een account aan op [Stripe](https://stripe.com). - Ga naar 'Developers' > 'API keys'. - Gebruik de test- of live-sleutel afhankelijk van je omgeving. ### Stap 2: Stripe SDK installeren Voor bijvoorbeeld Node.js: ```bash npm install stripe ``` ### Stap 3: Betalingen verwerken **Stapsgewijze instructies:** - Maak een betalingsintentie aan. - Bevestig de betaling. - Verwerk de resultaten. **Voorbeeldcode (Node.js):** ```javascript const Stripe = require('stripe'); const stripe = new Stripe('je_test_api_sleutel'); async function createPaymentIntent(amount, currency='EUR') { try { const paymentIntent = await stripe.paymentIntents.create({ amount: amount, // bedrag in centen currency: currency, }); console.log('PaymentIntent aangemaakt:', paymentIntent.id); return paymentIntent.client_secret; } catch (error) { console.error('Fout bij creëren PaymentIntent:', error); } } ``` ### Valkuilen en best practices - Gebruik altijd de `client_secret` op de frontend voor betaling. - Valideer betaling op serverzijde. - Gebruik webhook endpoints om betalingstransacties te monitoren. --- ## 5. Integratie met Twilio ### Stap 1: Twilio-account en API-sleutel - Maak een account op [Twilio](https://twilio.com). - Verkrijg je Account SID en Auth Token. - Koop een Twilio-telefoonnummer. ### Stap 2: Twilio SDK installeren Voor Node.js: ```bash npm install twilio ``` ### Stap 3: SMS-berichten verzenden **Voorbeeldcode:** ```javascript const twilio = require('twilio'); const accountSid = 'je_account_SID'; const authToken = 'je_auth_token'; const client = new twilio(accountSid, authToken); async function sendSms(to, message) { try { const messageInstance = await client.messages.create({ body: message, from: '+1234567890', // jouw Twilio-nummer to: to, }); console.log('SMS verzonden:', messageInstance.sid); } catch (error) { console.error('Fout bij verzenden SMS:', error); } } ``` ### Valkuilen en best practices - Controleer of de telefoonnummerindeling correct is. - Beperk het aantal berichten per dag om kosten te beheersen. - Beveilig je Auth Token en gebruik environment variables. --- ## 6. Veelvoorkomende problemen en oplossingen | Probleem | Mogelijke oorzaak | Oplossing | |------------|---------------------|-----------| | API-sleutel wordt geweigerd | Verkeerde sleutel of onvoldoende rechten | Controleer en vernieuw sleutels | | Betaling mislukt | Onvoldoende saldo, foutieve gegevens | Vraag gebruiker om juiste gegevens | | SMS wordt niet afgeleverd | Verkeerd nummerformaat, blokkades | Controleer nummerindeling en status van bericht | --- ## 7. Conclusie Met deze gids kunnen ontwikkelaars de WeatherAPI naadloos integreren met Stripe en Twilio. Volg de stappen, gebruik de voorbeeldcode en houd rekening met de valkuilen om een veilige en robuuste integratie te realiseren. --- Voor verdere vragen of ondersteuning, raadpleeg de officiële documentatie van [WeatherAPI](https://docs.weatherapi.com), [Stripe](https://stripe.com/docs), en [Twilio](https://www.twilio.com/docs).

Zeker, hier is een gedetailleerde integratiegids voor je WeatherAPI met Stripe en Twilio: # WeatherAPI Integratiegids voor Ontwikkelaars ## Inleiding Deze gids helpt ontwikkelaars bij het integreren van WeatherAPI met Stripe en Twilio. WeatherAPI biedt real-time weergegevens via REST endpoints. ## Basis WeatherAPI Configuratie ### Authenticatie ```javascript const WEATHER_API_KEY = 'jouw_api_key_hier'; const BASE_URL = 'https://api.weatherapi.com/v1'; ``` ### Basis API Aanroep ```javascript // Voorbeeld: huidig weer ophalen async function getCurrentWeather(city) { const response = await fetch(`${BASE_URL}/current.json?key=${WEATHER_API_KEY}&q=${city}`); return await response.json(); } ``` ## Stripe Integratie ### Stap 1: Stripe Account Setup 1. Maak een Stripe account op [stripe.com](https://stripe.com) 2. Haal je API keys uit het Dashboard 3. Installeer Stripe SDK: `npm install stripe` ### Stap 2: Stripe Configuratie ```javascript const stripe = require('stripe')('sk_test_jouw_secret_key'); // Webhook secret voor betalingsbevestiging const WEBHOOK_SECRET = 'whsec_jouw_webhook_secret'; ``` ### Stap 3: Betalingssessie Aanmaken ```javascript async function createPaymentSession(amount, description) { try { const session = await stripe.checkout.sessions.create({ payment_method_types: ['card'], line_items: [{ price_data: { currency: 'eur', product_data: { name: 'WeatherAPI Premium', description: description, }, unit_amount: amount * 100, // Bedrag in centen }, quantity: 1, }], mode: 'payment', success_url: 'https://jouwdomein.com/success', cancel_url: 'https://jouwdomein.com/cancel', }); return session; } catch (error) { console.error('Stripe fout:', error); throw error; } } ``` ### Stap 4: Webhook Handler ```javascript app.post('/stripe-webhook', express.raw({type: 'application/json'}), async (request, response) => { const sig = request.headers['stripe-signature']; let event; try { event = stripe.webhooks.constructEvent(request.body, sig, WEBHOOK_SECRET); } catch (err) { return response.status(400).send(`Webhook Error: ${err.message}`); } // Behandel het event switch (event.type) { case 'payment_intent.succeeded': const paymentIntent = event.data.object; // Activeer WeatherAPI premium features await activatePremiumFeatures(paymentIntent.customer); break; default: console.log(`Unhandled event type: ${event.type}`); } response.json({received: true}); } ); ``` ## Twilio Integratie ### Stap 1: Twilio Account Setup 1. Registreer op [twilio.com](https://twilio.com) 2. Haal Account SID en Auth Token 3. Koop een telefoonnummer ### Stap 2: Twilio Configuratie ```javascript const twilio = require('twilio'); const client = twilio( 'TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN' ); ``` ### Stap 3: Weerwaarschuwing SMS ```javascript async function sendWeatherAlert(phoneNumber, city, alertType) { try { // Haal weergegevens op const weatherData = await getCurrentWeather(city); const message = `Weerwaarschuwing voor ${city}: Temperatuur: ${weatherData.current.temp_c}°C Conditie: ${weatherData.current.condition.text} Type waarschuwing: ${alertType}`; const sms = await client.messages.create({ body: message, from: '+1234567890', // Je Twilio telefoonnummer to: phoneNumber }); console.log('SMS verzonden:', sms.sid); return sms; } catch (error) { console.error('Twilio fout:', error); throw error; } } ``` ### Stap 4: Spraakwaarschuwing ```javascript async function sendVoiceAlert(phoneNumber, city) { try { const weatherData = await getCurrentWeather(city); const temp = weatherData.current.temp_c; const call = await client.calls.create({ twiml: `<Response> <Say language="nl-NL"> Weerwaarschuwing voor ${city}. Huidige temperatuur: ${temp} graden Celsius. Neem voorzorgsmaatregelen. </Say> </Response>`, to: phoneNumber, from: '+1234567890' }); return call; } catch (error) { console.error('Twilio voice fout:', error); throw error; } } ``` ## Gecombineerd Voorbeeld: Premium Weerservice ```javascript // Premium weerabonnement met automatische waarschuwingen async function setupPremiumWeatherService(userData, paymentInfo) { try { // Stap 1: Betaling verwerken via Stripe const paymentSession = await createPaymentSession( 9.99, 'Maandelijkse WeatherAPI Premium' ); // Stap 2: Webhook luistert naar succesvolle betaling // Stap 3: Na betaling: registreer gebruiker voor waarschuwingen await registerUserForAlerts(userData); // Stap 4: Bevestigings-SMS via Twilio await sendWeatherAlert( userData.phone, userData.city, 'Registratie voltooid' ); return paymentSession; } catch (error) { console.error('Service setup mislukt:', error); throw error; } } ``` ## Veelvoorkomende Valkuilen en Oplossingen ### Stripe Valkuilen 1. **Vergeten webhook te verifiëren** - **Oplossing**: Gebruik altijd `stripe.webhooks.constructEvent()` 2. **Testmodus in productie** - **Oplossing**: Wissel van `sk_test_` naar `sk_live_` keys 3. **Geen foutafhandeling** ```javascript // Goede foutafhandeling try { const payment = await stripe.paymentIntents.create({...}); } catch (error) { if (error.type === 'StripeCardError') { // Kaart afgewezen } else if (error.type === 'StripeRateLimitError') { // Te veel requests } } ``` ### Twilio Valkuilen 1. **Onjuiste telefoonnummerformattering** - **Oplossing**: Gebruik E.164 formaat: `+31612345678` 2. **Rate limiting negeren** - **Oplossing**: Implementeer backoff strategie ```javascript async function sendWithRetry(messageData, retries = 3) { for (let i = 0; i < retries; i++) { try { return await client.messages.create(messageData); } catch (error) { if (error.code === 20429) { // Rate limit await sleep(1000 * Math.pow(2, i)); // Exponentiële backoff continue; } throw error; } } } ``` 3. **Geen input validatie** - **Oplossing**: Valideer altijd telefoonnummers ```javascript function validatePhoneNumber(phone) { const phoneRegex = /^\+[1-9]\d{1,14}$/; return phoneRegex.test(phone); } ``` ## Best Practices ### Beveiliging 1. **API keys nooit in code** - Gebruik environment variables ```javascript require('dotenv').config(); const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY); ``` 2. **Input validatie** ```javascript function validateWeatherRequest(city) { if (!city || typeof city !== 'string') { throw new Error('Ongeldige stad opgegeven'); } // Voorkom SQL injection en andere aanvallen return city.replace(/[^a-zA-Z\s]/g, ''); } ``` ### Prestaties 1. **Caching implementeren** ```javascript const NodeCache = require('node-cache'); const weatherCache = new NodeCache({ stdTTL: 600 }); // 10 minuten cache async function getCachedWeather(city) { let weather = weatherCache.get(city); if (!weather) { weather = await getCurrentWeather(city); weatherCache.set(city, weather); } return weather; } ``` 2. **Asynchrone verwerking** ```javascript // Gebruik queues voor niet-kritieke taken const Queue = require('bull'); const alertQueue = new Queue('weather alerts'); alertQueue.process(async (job) => { return await sendWeatherAlert(job.data.phone, job.data.city); }); ``` ### Foutafhandeling ```javascript // Gestructureerde foutresponses function createErrorResponse(service, error, userMessage) { return { success: false, service: service, error: error.message, userMessage: userMessage, timestamp: new Date().toISOString() }; } // Gebruik in je API app.use((error, req, res, next) => { console.error('API Fout:', error); res.status(500).json( createErrorResponse('WeatherAPI', error, 'Er ging iets mis') ); }); ``` ## Teststrategie ```javascript // Unit tests voor integraties describe('Stripe Integration', () => { it('should create payment session', async () => { const session = await createPaymentSession(10, 'Test'); expect(session.url).toBeDefined(); expect(session.amount_total).toBe(1000); }); }); // Mock Twilio voor testing jest.mock('twilio', () => { return jest.fn().mockImplementation(() => ({ messages: { create: jest.fn().mockResolvedValue({ sid: 'mock_sid' }) } })); }); ``` ## Monitoring en Logging ```javascript // Logging setup const winston = require('winston'); const logger = winston.createLogger({ level: 'info', format: winston.format.json(), transports: [ new winston.transports.File({ filename: 'integration-errors.log' }) ] }); // Gebruik in integraties logger.info('Stripe payment initiated', { amount: amount, userId: user.id }); ``` Deze gids biedt een complete basis voor het integreren van WeatherAPI met Stripe en Twilio. Pas de code aan naar je specifieke use case en vergeet niet uitgebreid te testen voordat je naar productie gaat.