flutter-handling-http-and-json
Executes HTTP requests and handles JSON serialization in a Flutter app. Use when integrating with REST APIs or parsing structured data from external sources.
- License 许可
- MIT
- 最近更新
- 2026-06-13
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- flutter-handling-http-and-json
- description
- Executes HTTP requests and handles JSON serialization in a Flutter app. Use when integrating with REST APIs or parsing structured data from external sources.
03 SKILL.md 正文
Handling HTTP and JSON
Contents
- Core Guidelines
- Workflow: Executing HTTP Operations
- Workflow: Implementing JSON Serialization
- Examples
Core Guidelines
- Enforce HTTPS: iOS and Android disable cleartext (HTTP) connections by default. Always use HTTPS endpoints.
- Construct URIs Safely: Always use
Uri.https(authority, unencodedPath, [queryParameters])to build URLs safely. - Handle Status Codes: Always validate
http.Response.statusCode. Treat200and201as success. Throw explicit exceptions for other codes. - Prevent UI Jank: Move expensive JSON parsing (>16ms) to a background isolate using
compute().
Workflow: Executing HTTP Operations
- [ ] Add the
httppackage topubspec.yaml. - [ ] Configure platform permissions (Internet permission in
AndroidManifest.xml). - [ ] Construct the target
Uri. - [ ] Execute the HTTP method (
http.get,http.post,http.put,http.delete). - [ ] Validate the response and parse JSON payload.
Workflow: Implementing JSON Serialization
Small prototype / simple models: Use manual serialization with dart:convert.
- [ ] Define Model class with
finalproperties. - [ ] Implement
factory Model.fromJson(Map<String, dynamic> json). - [ ] Implement
Map<String, dynamic> toJson().
Production app / complex models: Use code generation with json_serializable or freezed.
- [ ] Add
json_annotationandjson_serializable(orfreezed) dependencies. - [ ] Add
part 'model_name.g.dart';directive. - [ ] Annotate class with
@JsonSerializable()or@freezed. - [ ] Run
dart run build_runner build --delete-conflicting-outputs.
Examples
HTTP GET with Manual Serialization
import 'dart:convert';
import 'package:http/http.dart' as http;
class Album {
final int id;
final String title;
const Album({required this.id, required this.title});
factory Album.fromJson(Map<String, dynamic> json) {
return Album(
id: json['id'] as int,
title: json['title'] as String,
);
}
}
Future<Album> fetchAlbum() async {
final uri = Uri.https('jsonplaceholder.typicode.com', '/albums/1');
final response = await http.get(uri);
if (response.statusCode == 200) {
return Album.fromJson(jsonDecode(response.body) as Map<String, dynamic>);
} else {
throw Exception('Failed to load album');
}
}
Background Parsing with compute
import 'dart:convert';
import 'package:flutter/foundation.dart';
import 'package:http/http.dart' as http;
List<Photo> parsePhotos(String responseBody) {
final parsed = (jsonDecode(responseBody) as List).cast<Map<String, Object?>>();
return parsed.map<Photo>(Photo.fromJson).toList();
}
Future<List<Photo>> fetchPhotos(http.Client client) async {
final uri = Uri.https('jsonplaceholder.typicode.com', '/photos');
final response = await client.get(uri);
if (response.statusCode == 200) {
return compute(parsePhotos, response.body);
} else {
throw Exception('Failed to load photos');
}
}
04 同仓库更多 Skills
hello-checker
Use this skill when asked to "verify", "check", or "validate" a file's existence and content. It provides a reliable workflow for confirming files meet their spec.
ask-skill
暂无简介
html-review-artifact
Framework-wide guidance for crafting polished human-review artifacts as markdown or HTML
converge-planning
Design a Converge playbook end-to-end. Use when the user says "plan a project", "design a playbook", "decompose into tasks", "scaffold a Converge workflow", "onboard to Converge", or asks how to write TASK.md / playbook.yml. Two entry points: plan a new playbook or update an existing one. Hand off to `/converge-control` after producing the playbook structure.
converge-control
Operate a Converge playbook end-to-end — start runs, monitor progress, narrow failures with `--select`, inspect runtime state, validate definitions, surgically reset subtrees, and stop stuck or orphaned runs. Use this skill whenever the user says "run my playbook", "execute this", "monitor the run", "converge failed", "the run is stuck", "retry failures", "babysit this playbook", "what's the status?", "show me the gantt", or asks how to use `converge run` / `--select` / `inspect` / `doctor` / `clean` / `stop`. Also use it for `HTTP 401` / `Invalid API key` failures on the first task — those are environment-not-playbook problems — and for any post-run cleanup work. Hand off to `converge-planning` if the user wants to design or restructure the playbook itself.
repair-taskts
Fix task.ts definition issues — Seed syntax, missing .build(), empty checks, import errors, TypeScript errors